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(54) Method for generating a user interface on a HAVi device for the control of a Non-HAVi device 



(57) The invention relates to the bridging technology 
of home networks, namely a HAVi home network and 
an IP based network such as UPnP network. When 
combining both networks via a gateway (1 0) the service 
of controlling a UPnP device from a HAVi device shall 
be provided. A problem arises from the fact that not for 
every UPnP device a corresponding device control 
module exists in the HAVi network technology so that 
some of the UPnP devices cannot be controlled via a 
corresponding device control module (DCM). 

The invention solves this problem by means of two 
basic software elements, namely a specialized function 
control module (FCM) to be implemented in the gateway 
(10) and a JAVA programme (HAVLET) that is run on 
the HAVi controller (31). The UPnP network is an IP 
based network. Therefore each UPnP device is repre- 



sented by a so-called XML document. Such an XML 
document includes a number of XML descriptions, 
which are nothing else than function descriptions forthe 
controllable elements. A function control module (FCM) 
according to the invention includes means for request- 
ing the function descriptions of the UPnP device and for 
forwarding these function descriptions to the HAVi con- 
troller (31). The function control module (FCM) may in- 
clude means for translating the retrieved function de- 
scriptions before forwarding to the HAVi controller (31 ). 
In the HAVi controller (31) the JAVA programme (HAV- 
LET) is run and this programme takes the function de- 
scriptions received from the gateway (1 0) and gener- 
ates a user interface with this information. The JAVA 
programme may be uploaded into the HAVi controller 
31 during the configuration phase of the HAVi network. 
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Description 

[0001] The invention relates to a method for generat- 
ing a user interface on a HAVi device for the control of 
a Non-HAVi device. This invention in particular applies 
to the field of domestic communication networks. The 
invention also concerns a gateway for use in the method 
for generating a user interface as well as two types of 
computer programme products. 

Background 

[0002] A few years ago the typical home audio/video 
equipment setup was characterized by a mix of CE de- 
vices of different types, e.g. a radio receiver, a CD play- 
er, a pair of speakers, a television set. a video cassette 
recorder, a tape deck, a DVD player, a satellite receiver 
and the like. For interaction of the devices point-to-point 
connection of analogue/digital input/outputs had to be 
made. For this purpose various kinds of different wires 
were available like Scart cables, Cinch cables, Coax ca- 
bles, optical fibre, and so forth. 

[0003] Meanwhile there are strong activities in the 
consumer electronics field to avoid this type of point-to- 
point connections. A number of standards for home net- 
works already exist that can be used to connect all the 
different components to each other via a single type of 
network cable. In the consumer electronics field first of 
all the IEEE1394 bus standard should be mentioned 
here. The IEEE1 394 bus system provides for a high data 
rate communication between the CE devices. The cable 
version supports data rates of 100, 200 and 400 Mbit/s. 
This is enough to transport asynchronous data for con- 
trolling a network station as well as isochronous audio 
and video streams in parallel. Isochronous and asyn- 
chronous data transfer modes are supported. However, 
the IEEE1394 standard specifies only the lower layers 
of the ISO/OSI reference model, namely the physical 
layer, the data link layer and the transaction layer. 
Therefore, the higher layers namely transport layer, ses- 
sion layer, presentation layer and application layer are 
left open for proprietary definition. 
[0004] A consortium of consumer electronics compa- 
nies worked on a standard for the audio/video electron- 
ics and the multimedia industry wherein the higher com- 
munication layers have been specified. This standard is 
referred to as the HAVi standard, where HAVi stands for 
Home Audio/Video interoperability. This standard pri- 
marily has defined an interoperability middleware that 
ensures that products of different vendors can interop- 
erate, i.e. cooperate to perform application tasks. The 
application layer remains completely open to proprietary 
solutions. 

[0005] Another consortium of companies, in particular 
computer companies including Microsoft, started anoth- 
er initiative for setting up a network control software 
stack based on Internet Protocols (IP). This network 
system is called UPnP (Universal Plug and Play) net- 



work. This system shall be open to all kinds of electronic 
components that could be integrated in a network in par- 
ticular personal computers, but also electronic applianc- 
es in a household like refrigerators, microwave ovens, 

5 heating control, air conditioning control, security sys- 
tems, washing machines and the like. The UPnP net- 
work system supports controlling of all these appliances 
via the Internet, therefore, even if somebody is on a jour- 
ney, he can manage to monitor and control his home 

10 appliances. 

[0006] Even though HAVi and UPnP have sometimes 
been seen as competitors, and in some ways they are, 
they serve somewhat different markets and have some- 
what different goals. It is therefore foreseen a scenario 

15 that both networks exist in parallel in a household and 
that bridging is possible between the two for data ex- 
change and interaction between UPnP network compo- 
nents and HAVi network components. This however 
calls for the creation of the bridging technology between 

20 HAVi and UPnP networks. 

[0007] When talking of a bridge between UPnP and 
HAVi networks this technically means that a data packet 
is transferred to the other side on the data link layer. 
When transferring a data packet on a higher layer of the 

25 ISO/OSI reference model the bridging device is then 
called a gateway. As the data packets are transferred 
from HAVi to UPnP network or vice versa on a higher 
layer, the bridging device will be called gateway herein- 
after. This is not meant limiting however. 

30 [0008] With the gateway in between both networks, it 
shall be possible to control a HAVi device in the HAVi 
network from a UPnP device in the UPnP network. Also 
it shall be supported to control a UPnP device from a 
HAVi device. 

35 [0009] For the controlling of the HAVi device from a 
UPnP device it is required to represent the HAVi devices 
as a UPnP device. Here, specific problems need to be 
solved that are not part of the present invention. 
[0010] The invention deals with the problem of con- 

40 trolling a UPnP device from a HAVi device. To under- 
stand the invention it is advantageous to first explain the 
architecture of the HAVi system. According to the HAVi 
architecture a CE device in the network is controlled 
through abstract representations of the CE device. The 

45 architecture allows a module (e.g. device representa- 
tion, controller, etc.) to send commands or control infor- 
mation to another module in the home network. A HAVi- 
compliant device contains data (above abstract repre- 
sentation referred to as device control module DCM) re- 

50 lating to its user interface and to its control capabilities. 
This data includes for example HAVi byte code (Java 
code) that can be uploaded and executed by other de- 
vices on the network. A HAVi-compliant device has, as 
a minimum, enough functionality to communicate with 

55 other devices in the HAVi network. During interaction, 
devices may exchange control data and application data 
in a peer-to-peer fashion. The HAVi specification distin- 
guishes between controllers and controlled devices. A 
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controller is a device that acts as a host for a controlled 
device. A controller hosts the abstract representation for 
the controlled devices. 

[0011] The HAVi specification defines HAVi compliant 
CE devices in the following categories: Full-AV devices 5 
(FAVs), Intermediate-AV devices (lAVs) and Base-AV 
devices (BAVs). 

[0012] An FAV contains a complete set of software 
components of the HAVi software architecture. An FAV 
is characterized in that it has a run-time environment for 10 
HAVi byte code. This means it has a JAVA virtual ma- 
chine. This enables an FAV device to download JAVA 
byte code form other devices, e.g. for providing en- 
hanced capability for their control. An FAV may be 
formed by e.g. a HAVi compliant set top box, a HAVi is 
compliant digital TV receiver or a home personal com- 
puter. For example an intelligent TV receiver can be the 
HAVi controller of other devices connected to the net- 
work. The receiver gets the byte code uploaded from 
another device in the network. An icon representing this 20 
device can be made to appear on the TV screen and 
user interaction with the icon may cause elements of the 
control programme to actuate the represented device in 
a pre-specified manner. 

[0013] An IAV does not provide a run-time environ- 25 
ment for HAVi byte code but may provide native support 
for control of specific devices on the home network. An 
IAV comprises embedded software elements that pro- 
vide an interface for controlling general functions of the 
specific devices. These software elements need not be 30 
HAVi byte code and may be implemented as native ap- 
plications on the IAV that use native interfaces to access 
other devices. 

[001 4] A BAV may provide uploadable HAVi byte code 
but does not host any of the software elements of the 35 
HAVi architecture. A BAV is controllable through an FAV 
by means of the former uploaded byte code. A BAV is 
controllable through an IAV via its DCM/FCM that has 
been uploaded by an FAV. Communication between an 
FAV or an IAV on the one hand and a BAV on the other 40 
hand requires that the HAVi byte code is instantiated by 
an FAV. 

[0015] The HAVi specification includes a number of 
main software elements that are listed below. For a more 
detailed explanation of these elements it is referred to 45 
the HAVi specification. An existing version of the HAVi 
specification is V1 .1 , published May 15, 2001 and avail- 
able from HAVi, INC., 2694 Bishop Drive, Suite 275 San 
Ramon, CA 94683, USA. 

50 

1. The 1394 communications media manager 
(CMM) acts as an interface between the other soft- 
ware elements and IEEE1394 bus. 



from the network. 

3. A registry - maintains information about the ap- 
pliances connected to the network and thef unctions 
they offer. Applications can obtain this information 
from the registry. 

4. A messaging system (MS) - serves as an API (Ap- 
plication Programming Interface) that facilitates 
communication between the software elements of 
the various appliances on the network. The mes- 
saging system provides the HAVi software ele- 
ments with communication facilities. It is independ- 
ent of the network and the transport layers. The 
messaging system is in charge of allocating identi- 
fiers for the abstract representations at the FAV or 
IAV. These identifiers are first used by the abstract 
representations to register at the FAV or IAV. Then 
they are used by the abstract representations to 
identify each other within the home network. When 
a first abstract representation wants to send a mes- 
sageto another abstract representation it has to use 
the identifier of the latter while invoking the messag- 
ing API. 

5. A device control module (DCM) - represents an 
appliance on the network. An application program 
can interact directly with a DCM. Within a DCM a 
number of functional control modules (FCM) may 
be contained. In a HAVi network, a functionality is 
represented by an FCM. Hierarchically speaking an 
FCM is always contained in a DCM, representing a 
device. A DCM may contain more than one FCM (e. 
g. a DCM representing a digital VCR contains a 
Tuner FCM and a VCR FCM) but there is only one 
DCM for each HAVi device. 

6. A DCM manager - installs the DCMs. It automat- 
ically reacts to changes in the network by installing 
new DCMs for new BAV appliances. 

7. A data driven interaction (DDI) controller - 
renders GUI (Graphical User Interface) on an appli- 
ance display on behalf of a HAVi software element. 
It supports a wide range of displays varying from 
graphical to text only. 

8. Astream manager (SMG R) - creates connections 
and routes real time AV streams between two or 
more appliances on the network. 

[001 6] Basic HAVi interoperability addresses the gen- 
eral need to allow existing devices to communicate at a 
basic level of functionality. To achieve this, HAVi defines 
and uses a generic set of control messages that enable 
one device to communicate with another device and a 
set of event messages that it should reasonably expect 
from a device given its class (TV, VCR, DVD player, etc). 



2. An event manager (EM) informs the various soft- 55 
ware elements of events in the network such as the 
changes in the network configuration that occur 
when appliances (devices) are added or removed 
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To support this approach a basic set of mechanism is 
required: Device discovery; Communication; and a HAVi 
message set. As to device discovery: Each device in the 
home network needs a well-defined method that allows 
it to advertise its capabilities to others. The HAVi ap- 
proach is to utilize so-called SDD data: Self Describing 
Data. The SDD data is required on all HAVi devices in 
the network. SDD data contains information about the 
device, which can be accessed by other devices. The 
SDD data contains as a minimum enough information 
to allow instantiation of a so-called embedded device 
control module (embedded DCM). An embedded DCM 
is a piece of code preinstalled on a controlling IAV or 
FAV in a platform dependent code and using native in- 
terfaces to access the lAVs for FAVs resources. As men- 
tioned above, a DCM for a device is a software element 
that provides an interface forcontrol of general functions 
of the device. Instantiation of an embedded DCM results 
in registration of the devices capabilities with a registry. 
The registry provides a directory service and enables 
an object on the network to locate another object on the 
network. Registering allows applications to inferthe ba- 
sic set of command messages that can be sent a spe- 
cific device on the network. 

[0017] As to communication: Once an application has 
determined the capabilities of a device the application 
needs to be able to access those capabilities. This re- 
quires a general communication facility allowing appli- 
cations to issue requests to devices. The service is pro- 
vided by the HAVi messaging systems and DCMs. The 
application sends HAVi messages to DCMs, the DCM 
then engage in proprietary communication with the de- 
vices. 

[0018] As to HAVI message sets: In order to support 
basic interoperability a well defined set of messages is 
required that must be supported by all devices of a par- 
ticular known class (e.g. the class of TV receivers, the 
class of VCRs. the class of DVD players etc.). This en- 
sures that a device can work with existing devices, as 
well as with future devices, irrespective of the manufac- 
turer. These three basic requirements support a certain 
minimal level of interoperability. Since any device can 
query the capabilities of another device via the registry, 
any device can determine the message set supported 
by another device. Since applications have access to 
the messaging system, any device can interact with any 
other device. 

[0019] Basic HAVi interoperability ensures that devic- 
es can interoperate at a basic level of functionality. How- 
ever, a more extended mechanism is needed to also al- 
low a device to communicate to other devices with any 
additional functionality that is not present in the embed- 
ded DCMs on an FAV. For example, embedded DCMs 
may not support all features of existing products and are 
unlikely to support those totally new ones of future prod- 
uct categories. 

[0020] HAVi 'Level 2' interoperability provides this 
mechanism. To achieve this the HAVi architecture al- 



lows uploadable DCMs as an alternative to so called 
embedded device control modules. An uploadable DCM 
may be provided by any suitable source, but a likely 
technique is to place the uploadable DCM in the HAVI 

5 SDD data on the BAV device and upload from the BAV 
to the FAV device when the BAV is connected to the 
home network. Because the HAVi architecture is ven- 
dor-neutral it is necessary that the uploaded DCM will 
work on a variety of FAV devices all with potentially dif- 

10 ferent hardware architectures. To achieve this, upload- 
ed DCMs are implemented in HAVi (JAVA) byte code. 
The Java byte code run-time environment on FAV de- 
vices supports the instantiation and execution of upload- 
ed DCMs. Once created and running within an FAV de- 

15 vice the DCM communicates with the BAV devices in 
the same manner as described above. 
[0021] Underthe new scenario, where a HAVi network 
is connected with a UPnP network via a gateway, and a 
UPnP device shall be controlled by a HAVi FAV device, 

20 the additional problem occurs that none of the UPnP de- 
vices provides a HAVi DCM that could be uploaded to 
the HAVI FAV device. Therefore, neither basic nor level 
2 interoperability is available for the controlling of UPnP 
devices from a HAVi network station. 

25 

Invention 

[0022] It is an object of the invention to solve the prob- 
lem of controlling a Non-HAVi compliant device in a 

30 Non-HAVi network from a HAVi compliant FAV device in 
a HAVi network via a gateway. For some of the UPnP 
devices there could exist in the gateway device a corre- 
sponding representation in the form of a DCM with an 
embedded device specific FCM. This DCM/FCM could 

35 be used for generating a user interface on the HAVi FAV 
device for controlling the UPnP device using basic in- 
teroperability. The user could, therefore, generate con- 
trol commands for the UPnP device that need to be in- 
terpreted in the gateway and transformed into a corre- 

40 sponding UPnP command that would be understood in 
the UPnP device to be controlled. 
[0023] A problem is however that there are certainly 
UPnP devices existing for which no corresponding rep- 
resentation in the form of a FCM, exist in the HAVi sys- 

45 tern. For such a case there is the possibility implement- 
ed in the HAVi system to generate a so-called generic 
FCM. In case of an unknown UPnP device, the gateway 
can only provide a DCM having embedded a generic 
FCM for the control of the UPnP device. With this ge- 

50 neric FCM the HAVi FAV device cannot generate a user 
interface because none of the functions of the U Pn P de- 
vice are known in the generic FCM. This is the crux of 
the problem underlying the invention. 
[0024] The invention solves the problem with the 

55 means of the independent claims 1 , 8, 12 and 15. The 
invention utilizes the possibility in the HAVi system to 
download from a DCM a so-called HAVLET that is exe- 
cutable JAVA byte code to generate a user interface on 
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the HAVi controller. This HAVLET software piece inter- 
acts with the DCM for the Non-HAVi devices stored and 
executed in the gateway. The Non-Havi DCM contains 
a specialized Non-HAVi FCM that includes the software 
routines for requesting the function descriptions of a 
Non-HAVi device and for forwarding them to the HAVI 
FAV device. The HAVLET running on the HAVi FAV de- 
vice takes the function descriptions of the Non-HAVi de- 
vice and generates a corresponding user interface with 
these function descriptions. 

[0025] Advantageous, modifications and improve- 
ments of the invention are listed in the dependent 
claims. Very advantageous is, if the FCM running on the 
gateway comprises means for translating the function 
descriptions read from the Non-HAVi device (23) into a 
data form supported by the HAVi system before forward- 
ing to the HAVi controller. This improvement simplifies 
the HAVLET software running on the HAVi controller 
very much. The means for translating the function de- 
scription of the Non-HAVi device need not be included 
in the HAVLET, thus making it unnecessary to upload a 
corresponding software code into the HAVi FAV device, 
thereby reducing memory requirements in the HAVI FAV 
device. Likewise the processor of the HAVi FAV device 
is relieved. 

[0026] The invention can best be utilized if a HAVi net- 
work needs to be combined with an IP-based network, 
e.g. the UPnP network. In case of a UPnP network a 
UPnP device is represented by means of so-called XML 
descriptions for each function of a UPnP device. The 
XML descriptions will be requested by the specialised 
function control module which is of the type generic FCM 
(according to the HAVi specification) running on the 
gateway, translated and then be forwarded to the HAV- 
LET executed by the HAVi controller. For each translat- 
ed function description the HAVLET will generate a 
graphical representation preferably in the form of a but- 
ton, slider, query button or input field together with a 
symbol or expression that explains the meaning. 
[0027] A gateway according to the invention is 
claimed in independent claim 8. 
[0028] Independent claim 12 claims a computer pro- 
gramme product, namely a function control module 
FCM for the gateway according to the invention. 
[0029] Independent claim 15 claims a computer pro- 
gramme product, in particular HAVLET, running on the 
HAVi controller according to the invention. 

Drawings 

[0030] Exemplary embodiments of the invention are 
illustrated in the drawings and are explained in more de- 
tail in the following description. 
[0031] In the figures: 

Fig. 1 shows an example of a HAVi network and a 
UPnP net-work connected to each other via a 
gateway; 
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Fig. 2 shows the basic software elements interacting 
to each other of the UPnP device, the gateway 
and the HAVi controller; 
Fig. 3 shows an example of a user interface for the 
5 control of a UPnP security camera displayed 

on the HAVi controller; 
Fig. 4 shows a programme listing for a function con- 
trol module for the use in the gateway accord- 
ing to the invention; 
10 Fig. 5 shows a programme listing for a HAVLET to be 
executed by a HAVi controller according to the 
invention; and 
Fig. 6 shows a programme listing for a service de- 
scription routine that will be called when exe- 
cuting the function control modul. 

Exemplary embodiments of the invention 

[0032] Fig. 1 depictsthe princip I e structure of two net- 
works being connected to each other via a gateway 10. 
On the left side of the figure it is shown a U Pn P network. 
As an example reference number 21 denotes a washing 
machine, reference number 22 a refrigerator, reference 
number 23 a security camera, reference 24 a heating 
25 control unit, and reference 25 a personal computer hav- 
ing an ISDN/DSL Internet connection. All these UPnP 
devices are connected to an Ethernet data bus 20 for 
data exchange. The Ethernet bus lines are also con- 
nected with gateway 1 0. On the right side of figure 1 is 
30 shown a HAVi network. The reference number 31 marks 
a TV set, reference number 32 denotes a VCR. refer- 
ence number 33 denotes a DVD player and reference 
number 34 stands for a set top box such as a digital sat- 
ellite receiver. The HAVi network stations are connected 
35 to an IEEE1394 bus 30 for data exchange. The gateway 
1 0 is also connected to the 1394 bus 30. The gateway 
10 comprises an IP protocol stack 11, on one side, a 
HAVi protocol stack 12 on the other side as well as soft- 
ware for carrying out the translation or mapping of con- 
40 trol messages and events from one networkto the other. 
[0033] The HAVi as well as the UPnP specifications 
are known in the art. Therefore, there is no need to ex- 
plain all the details in these specifications for the pur- 
pose of disclosing the present invention. It is therefore 
45 expressively referred to the HAVi specification as well 
as the UPnP specification for this purpose. The UPnP 
specification can be obtained from the UPnP Forum 
managed by Microsoft Incorporation. 
[0034] As mentioned before the UPnP network sys- 
50 tern is based on the existing Internet protocols. A graph- 
ical user interface (GUI) for controlling UPnP devices 
from an UPnP controller, e.g. the personal computer 25 
may consist of a plurality of icons displayed on the com- 
puter monitor. When a user selects an icon, the HTML 
55 pages are retrieved from of the device in question. The 
HTML pages are displayed for the user. This allows the 
user to control the given device. In the UPnP specifica- 
tion it is defined that each UPnP device comprises a list 
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of services, which are provided by the device. Each of 
these services is described in an XML document, where 
XML stands for Extension Mark-up Language, i.e. Inter- 
net technology. Each XML document contains a detailed 
description of all control possibilities within the service. 
These XML documents will be utilized for controlling a 
UPnP device from a HAVi controller. 
[0035] The control process of the UPnP device from 
a HAVi FAV device is illustrated in Fig. 2. Identical ref- 
erence numbers denote the same components as 
shown in Fig. 1 and need not be explained again. In Fig. 
2 the Ethernet interface circuit 26 with which UPnP de- 
vices as well as the gateway are equipped are separate- 
ly shown. Similarly the 1394 bus interface 35 for the 
HAVi network components and the gateway 1 0 are like- 
wise shown. In addition the basic software elements of 
the security camera 23, the gateway 1 0 and the TV set 
31 are shown in Fig. 2. A security camera 23 contains 
an XML document in which the control possibilities for 
the security camera are listed. The important software 
element of the gateway is a device control module DCM 
containing a specified function control module FCM as 
well as an executable JAVA programme HAVLET. The 
JAVA programme HAVLET is provided for an upload to 
a HAVi FAV device during the configuration phase of the 
HAVi network. Therefore, the very important software 
element of the HAVicontroller31 concernsthis HAVLET. 
[0036] For controlling the security camera 23 the 
gateway interacts with the security camera 23 and the 
TV set 31 as follows. 

[0037] After finishing of the configuration phase in 
both networks, all the network components within the 
HAVi network as well as in the UPnP network can be 
controlled from the TV set 31 . A user interface for con- 
trolling these devices is built in the form of a list of icons 
for each controllable device. It is the communications 
media manager CMM, the event manager EM, the reg- 
istry and the messaging system MS of the HAVi protocol 
stack, that are utilized for collecting the information of 
all controllable elements be it in the HAVi network or in 
the UPnP networks. Of course, the gateway 10 includes 
corresponding software elements and interfaces so that 
the mapping of the UPnP devices in the HAVi registry is 
possible. This process however is pre-supposed to be 
prior art and will not be explained in further detail here. 
[0038] A user may now wish to control the security 
camera from the TV set 31 in the HAVi network. For this 
purpose he selects the corresponding icon on the TV 
screen. This event will start the download of the HAV- 
LET into the internal memory of the TV set 31 . Right 
after the download, the execution of the HAVLET is 
started. The HAVLET is an executable JAVA pro- 
gramme. As JAVA is a platform independent program- 
ming language, it will run on each HAVi FAV device that 
has a run-time environment for JAVA byte code. 
[0039] Third, the executed HAVLET sends a request 
for retrieving information about the security camera 23 
to the gateway 1 0. This request will be accepted by the 



running UPnP function control module FCM that itself 
retrieves the XML document/s stored on the webserver 
of the security camera 23. Each XML document con- 
tains descriptions of the control possibilities for the se- 

5 curity camera 23. The FCM translates the XML descrip- 
tions into a struct (a set of variables) and forwards them 
to the HAVLET running in the TV set 31 . The HAVLET 
then takes these function descriptions and generates for 
each controllable element a graphical representation 

10 such as button, slider, query button, inputfield orthe like 
to generate the graphical user interface for the control 
of the security camera on the TV screen. The flow of 
information is illustrated in Fig. 2 with arrows and the 
numbering expresses the order of interaction. 

15 [0040] The graphical user interface for the security 
camera 23 is shown in Fig. 3. For each controllable el- 
ement of the security camera a graphical representation 
is generated, e.g. for the brightness setting a slider is 
shown on the TV screen. With a mouse pointer the 

20 brightness can directly be controlled by means of the 
left/right buttons positioned at the left and right side of 
the slider. Also the slider itself could be dragged to the 
wanted position as known from a great variety of com- 
puter menus. At the left side of the slider for the bright- 

25 ness adjustment the expression Set-Brightness is 
shown in writing. This expression is directly taken over 
from the XML description for this controllable element. 
The FCM running in the gateway does not necessarily 
know the meaning of this expression. This is evident if 

30 one considers that a new type of product can be inte- 
grated in the UPnP network for which today nobody 
knows what the controllable elements are. In such a 
case the user has to make the right interpretation of this 
controllable element by himself. Below the brightness 

35 slider a GetBrightness button is positioned. This is an 
example of a query button. By depressingthis query but- 
ton the current brightness set value will be read out and 
displayed beside the button. Below the GetBrightness 
button are positioned simple buttons Increase-Bright- 

40 ness and DecreaseBrightness. These buttons have the 
same effect as the right and left buttons of the SetBright- 
ness slider. An example of an input field is the field Set- 
DefaultRotation. Here a number is requested with this 
field and shall be entered into the input mask. The input 

45 parameter determines the rotation of the security cam- 
era for getting another view. Instead of displaying the 
extracted expression for the respective control element 
derived from the XML description, a self-explanatory 
symbol could be displayed in the user interface. This 

50 however calls for the need to have pre-defined user in- 
terface components installed in the HAVLET for the dif- 
ferent services of the various possible UPnP devices. 
Even if a new type of appliance will be integrated in the 
UPnP network, the pre-defined user interface compo- 

55 nent could be used if this new device provides a service 
for which the user interface components are already 
provided in the HAVLET. For unknown services howev- 
er, this solution would not work. Another solution is that 
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there will be amix of both different solutions foroneserv- 
ice. For all the parameters in the XML description to 
which already a symbol had been assigned, a corre- 
sponding symbol could be displayed in the user inter- 
face. For the unknown parameters however, the corre- 
sponding expressions need to be shown. 
[0041] The XML document of a UPnP device can be 
regarded as a standard implementation of the UPnP 
specification. Forthe realization of the present invention 
no extraordinary programming has to be made here. 
The basic software elements for realization of the 
present invention are the UPnP FCM running on the 
gateway and the HAVLET uploaded into the HAVi FAV 
device. Both software elements include extraordinary 
routines forthe realization of the invention. 
[0042] Fig. 4 shows the programme listing of the func- 
tion control module forthe UPnP network. It is somehow 
a 'generic' FCM that will always be used for the control 
of any UPnP device. The programming language is 
JAVA. This is a well-known programming language 
widely used so that the particular syntax need not be 
explained here. The important routines for implementing 
the invention are labelled. With label (§) the routine for 
extracting the services from the XML document is 
marked. This routine therefore extracts which kind of 
service the requested UPnP device offers. For example 
the UPnP security camera offers the service of providing 
a stream of video pictures in a particular format like 
JPEG or Image at a certain compression level and res- 
olution. 

[0043] The GET_SERVICE_DESCRIPTION routine 
marked with label ® requests the information how 
many services the UPnP device offers. 
With the GET_SERVICE_INFORMATION_LIST routine 
marked with label © the information about every control 
possibility of the selected service can be retrieved. The 
routine PERFORM_CONTROL_COMMAND is provid- 
ed for sending a control command to a UPnP device, 
see label © . The routine PERFORM_DEVICE_ 
VARIABLE_QUERY is provided for retrieving the cur- 
rent variable value from a UPnP device, see label (£) . 
These routines will be executed upon a request from the 
HAVLET that runs on the HAVi device. 
[0044] For the routine call corresponding instructions 
are hold in the second part of the programme listing 
headed methods for answering the incoming request. 
Expressively it is referred to the routine call 
DO_GET_SERVICE_DESCRIPTION marked with label 
©, and DO_GET_SERVICE_INFORMATION_LIST 
marked with label© . A further important routine for the 
implementation of the invention is the routine sendCon- 
trolCommand for sending a control command to the UP- 
nP device. This routine is marked with label (0) . Within 
this routine a response message is also evaluated and 
forwarded to the HAVLET in the HAVi device. Also im- 
portant forthe implementation of the invention is the rou- 
tine queryDeviceVariable marked with labeKj) . This rou- 
tine is started if the HAVLET has sent a corresponding 



request. For example if the user has pressed a query 
button, this routine will be called. Again in this routine a 
response message will be sent back to the HAVi device. 
With the routine receiveHttpNotifyData marked with la- 

5 belQ UPnP events will be handled. 

[0045] The JAVA source code of a HAVLET imple- 
menting the invention is shown in Fig. 5. The main task 
of the HAVLET is to build the user interface for control- 
ling a UPnP device. The complete routine for building 

10 the Ul is labelled ® . The HAVLET contains corre- 
sponding routines for getting the service descriptions for 
a UPnP device marked with label © , for getting the 
service information list marked with label © , for per- 
forming a control command marked with label ® and 

15 for performing a device variable query marked with label 

[0046] The function control module is integrated in a 
device control module according to the HAVi specifica- 
tion. Therefore what needs to be done is to programme 

20 a device control module having embedded the function 
control module of Fig. 4. This programme is regarded to 
be a standard implementation of the HAVi specification 
that needs not to be explained in detail. That is why the 
listing of the DCM is not being shown. 

25 [0047] The part of the programme that performs the 
translation of the XML descriptions into a data form sup- 
ported by the HAVi system, is included in a routine called 
service description routine, shown in Fig. 6. The XML 
descriptions are basically in text format. These XML de- 

30 scriptions are evaluated. For example the programme 
part marked with label ® evaluates whether the XML 
descriptions contain some actions. These actions cor- 
respond to the controllable elements of the UPnP de- 
vice. They are translated into the HAVi-typical form of a 

35 variable set called 'struct'. This is performed by parsing 
the XML description and storing all information of inter- 
est in its local instance variables. 



40 Claims 

1. Method for generating a user interface on a HAVi 
device for the control of a Non-HAVi device, where 
HAVi stands for Home Audio/Video interoperability. 

45 the HAVi device (31 ) being a station of a HAVi net- 
work and the Non-HAVi device (23) being a station 
of a Non-HAVi network, both networks being con- 
nected to each other by a gateway (1 0), character- 
ized in that the gateway (10) runs a function control 

50 module (FCM) for the Non-HAVi devices that re- 
quests the descriptions of the functions of the 
Non-HAVi device (23) to be controlled and forwards 
them to the HAVi device (31 ) that generates the cor- 
responding user interface components forthe func- 

55 tions of the Non-HAVi device (23) by means of a 
JAVA programme (HAVLET) that runs on the HAVi 
device (31). 
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2. Method according to claim 1 , wherein the function 
control module (FCM) translates the function de- 
scriptions read from the Non-HAVi device (23) into 
a data form supported by the HAVi system before 
forwarding to the HAVi device (31). 

3. Method according to claim 1 , wherein the JAVA pro- 
gramme (HAVLET) translates the function descrip- 
tions read from the Non-HAVi device (23) into a data 
form supported by the HAVi system. 

4. Method according to one of claims 1 to 3, wherein 
the gateway (10) uploads the JAVA programme 
(HAVLET) to the HAVi device (31) during configu- 
ration. 

5. Method according to one of the previous claims, 
wherein the HAVi device (31) on which the user in- 
terface for controlling the Non-HAVi device (23) is 
generated is a HAVi device of the FAVtype, wherein 
FAV means Full Audio/Video HAVi device. 

6. Method according to one of the previous claims, 
wherein the Non-HAVi network is an IP based net- 
work, in particular a UPnP network, where UPnP 
stands for the Universal Plug and Play network sys- 
tem. 

7. Method according to claim 6, wherein the function 
descriptions of the Non-HAVi device (23) are XML 
descriptions, where XML stands for Extension 
Mark-up Language. 

8. Gateway for use in a method according to one of 
the previous claims, comprising an interface (35) for 
a HAVi network and comprising an interface (26) for 
a Non-HAVi network, characterized in that the 
gateway (10) comprises a function control module 
(FCM) that includes means for requesting the func- 
tion descriptions of the Non-HAVi device (23) and 
means for forwarding the function descriptions to 
the network station of the HAVi network on which a 
user interface for controlling a Non-HAVi (23) device 
shall be generated. 

9. Gateway according to claim 8, comprising a JAVA 
programme (HAVLET) that includes means for gen- 
erating a user interface with the function descrip- 
tions of a Non-HAVi device (23), this JAVA pro- 
gramme (HAVLET) being provided for an upload in- 
to a HAVi device (31). 

10. Gateway according to claim 8 or 9, wherein the 
function control module (FCM) comprises means 
for translating the function descriptions read from 
the Non-HAVi device (23) into a data form support- 
ed by the HAVi system before forwarding to the 
HAVi network. 



11. Gateway according to claim 9, wherein the JAVA 
programme (HAVLET) comprises means for trans- 
lating the function descriptions read from the 
Non-HAVi device (23) into a data form supported by 

5 the HAVi system 

12. Computer programme product, in particular func- 
tion control module (FCM) directly loadable into the 
internal memory of a gateway (10) according to one 

10 of the claims 8 to 1 1 , comprising means for request- 
ing function descriptions of a Non-HAVi device (23) 
and means for forwarding the function descriptions 
to a network station of a HAVi network on which a 
user interface for controlling the Non-HAVi device 

15 (23) shall be generated when said product is exe- 
cuted by a processor of the gateway (10). 

13. Computer programme product according to claim 
12, further comprising means for translating the 

20 function descriptions read from the Non-HAVi de- 
vice (23) into a data form supported by the HAVi sys- 
tem before forwarding to the HAVi network. 

14. Computer programme product according to claim 
25 12 or 13, wherein the function descriptions of the 

Non-HAVI device (23) are XML descriptions, where 
XML stands for Extension Mark-up Language. 

15. Computer programme product, in particular JAVA 
30 programme (HAVLET), directly loadable into the in- 
ternal memory of a HAVi device (31) of a HAVi net- 
work, comprising means for generating a user inter- 
face for the control of a Non-HAVi device (23) with 
the function descriptions retrieved from the 

35 Non-HAVi device (23), when said product is execut- 
ed by a processor of said HAVi device (31). 

16. Computer programme product according to claim 
15, wherein the retrieved function descriptions are 

40 translated XML descriptions of the Non-HAVi device 
(23), where XML stands for Extension Mark-up Lan- 
guage and the XML descriptions being translated 
into a data form supported by the HAVi system. 

45 17. Computer programme product according to claim 
15, further comprising means for translating the 
function descriptions retrieved from the Non-HAVi 
device (23) into a data form that is supported by the 
HAVi system and the function descriptions are XML 

50 descriptions, where XML stand for Extension Mark- 
up Language. 

18. Computer programme product according to one of 
claims 15 to 17, wherein the means for generating 
55 a user interface comprise means for assigning to a 
translated function description the appropriate 
graphical representation together with a symbol or 
expression that explains the meaning of the func- 
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tion description. 

19. Computer programme product according to claim 
18, wherein the graphical representation is in the 
form of a button, slider, query button or input field. 5 
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// 

// Copyright (c) 2000-2001, This software is the property of Thomson 
// multimedia, and shall not be reproduced, copied, or distributed 
// without written permission. 

// 

// 

// TITLE: FcmUpnp - Implementation of the FcmUpnp class. 

// AUTHOR (s) : Ingo Huetter 

// DATE CREATED: 21.09.2 001 

// FILENAME: FcmUpnp . j ava 

// PROJECT: DHN (HAVi implementation) 

// COPYRIGHT: (C) 2000-20 01 THOMSON multimedia, 

// THIS SOFTWARE IS THE PROPERTY OF THOMSON multimedia, AND SHALL NOT 
// BE REPRODUCED, COPIED, OR DISTRIBUTED WITHOUT WRITTEN PERMISSION. 

// 

// VERSION: 1 . 1 
// 

// MODIFICATION HISTORY: 

// DATE MODIFIED: 

/ / AUTHOR ( s ) : 

// MODIFICATION MADE: 

// PROBLEM CAUSING MODIFICATION: 

// 

// DESCRIPTION: 

// Base class of all FCMs for UPnP devices. If an UPnP device can be mapped to 
// an HAVi device, a special FCM for this kind of devices can be created (eg. 
// FcmUpnpDi splay) derived from FcmUpnp. If mapping is not possible, a 
// FcmUpnpNonhavi is derived from FcmUpnp. 

// 

// 

package com . thmult i . havi . upnp ; 

import org. havi . constants . * ; 
import org. havi . types . * / 
import org. havi . system. * ; 
import org. jdom. *; 
import org. j dom. input . * ; 
import org. j dom. output . * ; 
import j ava . io . * ; 
import java.net.*; 
import java.util.*; 



public class FcmUpnp 

extends j ava . lang . Object 

implements ReceiveHttpNotif ylnterf ace 

{ 

// Variables 

FcmListener f cm_listener , 

Sof twareElement fcm_se; 

FcmServerHelper fcm_server; 



HUID 

Targetld 
Vendorld 
short 
SEID 

String 

String 

String 

short 

int 



my__huid; 
my_target_id,- 
my_vendor_id - f 
my_f crn_index 
my_dcrn_s e i d ; 
my_user_jpref erred_name ; 
my__device_manuf acturer ; 
my_device_type ; 
my_interf ace_id; 
my_device__class ; 
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SAXBuilder builder; 
Vector service_list ; 

UpnpWebServer my_upnp_web_s erver ; 

// Constructor 

public FcmUpnp (UpnpWebServer upnp_web_s erver, String device_type) 
{ 

ray__upnp_web_server = upnp_web_s erver; 
my_device_type = device_type; 

builder = new SAXBuilder (} ; 

service_list = new Vector (}; 

} 

// install 

public int install (Element xml_device, Namespace ns, String base_url, SEID 
dcm_seid, short fcm_index, String user_pref erred_name, String 
device_manuf acturer, SEIDHolder fcm_seidh) 

{ 

/'/ save parameters 

my__f cm_index = fcm__index; 

my_dcm_seid = dcm_seid; 

my_user_pref erred_name = user_preferred_name; 

my~device_manuf acturer = device_manuf acturer ; 

my_device_class = Cons t Devi ceCl ass . LAV; 

// Create the listener and the software element 
try { 

fcm_listener = new FcmListener () ; 

fcm_se = new Sof twareElement (f cm_listener) ; 

fcm_seidh. setValue (f cm__se . getSeid ( ) ) ; 
) catch (Exception e) { 

f cmj3e , log (f cm_se . MSG_ERROR, f cmje ,MSG_SENDER_FCM, 
"FcmUpnp: : install : Creating f cm_listener oir £cm_se failed!"); 

return 1 ; 

) 

// Build the HUID 
try { 

my_target_id = new Targetld (ConstTargetType . FCM_NON61883 , new 
GUID(fcm_se. getSeid () .getValue () ) , 0, my_f cm_index) ; // CHANGE LATER 

my_vendor_id « new Vendorld ( f cm_se . getSeid ( ) . getValue ( ) ) ; 

my_huid = new HUID (my_target_id, (short) 0, my_vendor_id, false, 0) ; 
] catch (Exception e) { 

f cm_se . log (f cm_se . MSG_ERROR, f cmse ,MSG_SENDER_FCM, 
"FcmUpnp ins tall : Creating HUID failed!"); 

J 

// Create the FcmServerHelper 
try { 

fcm_server = new FcmServerHelper (fcm_se , Cons tTrans f erMode . SIMPLE) ; 
) catch (HaviGeneralException e) { 

fcm_se. log (f cm_se . MSG_ERR0R, f cmje .MSG_SENDER_FCM, 
"FcmUpnp install : Creating fcm_server failed!"); 

return 1 ; 

) 

// Extract the services from the XML device Description 

Element xml_service_list = xml_device .getChild ( "serviceList " , ns) ; 

if (xml_service_list != null) { 

j ava.util . List xml_services = 
xml_service_list .getChildren ( " service" ,ns) ; 

if (xml_services. size () > 0) { 

for (int i=0; i<xml_services . size ( ) ; i++) { 

Element xml^service = (Element ) xml_services . get ( i ) ; 
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ServiceDescription sd - new ServiceDescription () ; 
if (sd.init (xml_service, ns, base_url) == false) { 

f cm_se . log ( f cm__se . MS G_WARNI NG , f cm__se . MSG_SENDER_FCM , 
"FcmUpnp: : install : Fetching service information failed!"); 

break; ✓JTS 

} v&) 

service_list . addElement (sd) ; 

} 

} 

} 

// Subscribe for events 

my_upnp_web_server . registerClassHttpNotify (getUpnpEventNotif icationPath () , 
this); 

for {int i=0 ; i<service_lis t . size ( ) ; i++) { 
ServiceDescription sd = 
(ServiceDescription) service_list . elementAt (i) ; 

sd,sendEventSubscription("http://" +my_upnp_web_server . getHost Address ()+" :"+my_up 
np_web_server .get Port () +ge tUpnpEventNot if icationPath ( ) , 3 0000) ; 

} 

fcm_se.log(fcm_se.MSG_INIT, f cm_se . MSG__SENDER_FCM, "FcmUpnp was 
installed") ; 

return 0; 

} 

// uninstall 

public void uninstall 0 

{ 

If Unsubscribe for events 

for (int i=0 ; i<service_lis t . size ( ) ; i++) { 
ServiceDescription sd = 
(ServiceDescription) service_list . elementAt (i) ; 

sd. sendEventUnsubscription () ; 

} 

my_upnp_web_server . unregisterClassHttpNotify (getUpnpEventNotif icationPath { ) ) ; 

// Clear the ServiceList 
service__list . clear () ; 

// Unregister from the MessagingSystem 
try { 

f cm_se . close ( ) ; 
} catch (Exception e) { 

f cm_se . log ( f cm_se . MSG_WARNING , f cm_se . MSGJSENDER_FCM , 
"FcmUpnp :: uninstall : Unregistration from MessagingSystem failed"); 

} 

f cm_se . log ( f cm_se . MSG_INIT, f cmje . MSG_SENDER_FCM, "FcmUpnp : uninstall 
finished") ; 

} 

// 
// 

// FcmListener 
// — -« ~- — 

// (the receiveMsg method is called when a message for the Fcm arrives. If 

it 
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// is a standard FcmMessage the according method is called (see below) , 
which 

// can be overloaded by the final FCM) . 
// 

// mmmmm - mm 

public class FcmListener 
extends HaviListener 

{ 

public FcmListener ( > throws Havi Genera lExcept ion 

{ 
} 

public boolean receiveMsg (boolean haveReplied, byte protocolType , SEID 
sourceld, SEID destld, Status state, HaviByteArraylnputStream payload) 

{ 

boolean i_replied = false; 

if (state .getApiCode 0 == Cons tApi Code . MSG && state . getErrorCode () 
== ConstGeneralErrorCode.PRINT_SYSTEM_STATUS) { 

try { 

fcm__se . log (fcm_se . MSG_INFO_HIGH, 
fcm_se . MSG_SENDER_APPLICATION, » = = = = = = = = = = = = = = 

= = = = = = = = = = = ; 

f cm_se , log { fcm_se . MSG_INFO_HIGH, 
fcm_se .MSGJSENDER_APPLICATI0N, «======= System/Status information FcmUpnp - SEID 

"+f cm_se . getSeid () ) ; 

f cm_se . log (f cm_se , MSG_INFO_KIGH, 
fcm_se .MSG_SENDER__APPLICATTON, " 
mss = = = ====== = = = = = = = ====") ; 

} catch (HaviGeneralException ex) { 

} 

} else { 

f erase . log (f cm_se ,MSG_IK"FO_LOW, f cm_se .MSG_SENDER_FCM, "FcmUpnp 

received message") ; 

if (haveReplied == true) return i_replied; 

// Variables 

StatusHolder rreturn_status = new StatusHolder () ; 
Status return_status ; 
OperationCode received_pp_code ; 
byte control_f lags; 
int transaction_id; 

try { 

// Check protocol type 

if (protocolType != ConstProtocolType .HAVI_RMI) return 

i_replied; 

// Check the destination SEID 

if (destld. equals (f cm_se . getSeid () ) == false) return 

i_replied; 

// Read the remaining header 
payload . reset ( ) ; 

received_op_code = new OperationCode (payload) ; 
control_f lags « payload . readByte () ; 
transaction^id - payload. readlnt () ; 

// Check control flags 

if (control_f lags != 0) return i_replied; 
// check API code of opcode 

if (received_op_code .getApiCode () != Cons tApi Code . FCM) 

return i_replied; 
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} catch (Exception e) { 

f cm_se . log (f cra_se . MSGJWARNING , f cm_se . MSG_SENDER_FCM, 
"FcmListener: Reading the header failed. Give up ! " ) ; 

return i_replied; 

} 

// Ok, looks fine. Mow check the operation ID 
try { 

switch {received_op_code .getOpe rat ionld () ) { 
// 

// GET_HUID 

// = = == = 

// 

case Cons tFcmOpe rat ionld. GET_HUID : 
{ 

f cm_se . log (f cm_se . MSG_INFO_HIGH, 
f cm_se.MSG_SENDER_FCM / "FcmUpnp received GetHuid"); 

~ HUIDHolder huid = new HUIDHolder { ) ? 

return_status - do_GetHuid (huid} ; 

fcm_server .getHuidResp (sourceld, returnstatus, 
transact ion_id r huid. getValue () ) ; 

i_replied = true; 

} 

break; 

// 

// GET_DCM_SEID 
// ============ 

// 

case Const FcmOperat ionld . get_dcm_SEID : 

{ 

f cm_se . log (f cm_se . MSG_INFO_HIGH , 
f cm__se . MSG_SENDER_FCM / "FcmUpnp received GetDcmSeid") ; 

SEIDHolder dcm_seid = new SEIDHolder ( ) ; 

return_status = do_GetDcmSeid (dcm_seid) ; 

f cm_server . getDcmSeidResp (sourceld, return_status , 

transact ion__id, dcm__s e id . getValue () ) ; 

i_replied = true; 

} 

break; 

// 

// GET_FCM_TYPE 

// 

case ConstFcmOperat ionld . GET_FCM_TYPE : 
{ 

f cm_se . log (f cm_se . MSG_INFO_HIGH, 
f cm_se.MSG_SENDER_FCM i " FcmUpnp received GetFcmType") ; 

IntHolder fcnMiype = new IntHolder 0; 

return_status = do_GetFcrnType (f cm_type) ; 

f cm_server . getFcmTypeResp (sourceld, return_status , 

transact ion__id, fcm_type .getValue 0 ) ; 

i_replied = true; 

} 

break ; 

// 

// GET_POWER_STATE 
// = = === = = === 

// 

case ConstFcmOperationId.GET_POWER_STATE : 
{ 
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fcm_se . log (f cm_se . MSG__INFO_HIGH , 
fcm_se.MSG_SENDER__FCM / "FcmUpnp received GetPowerState" ) ; 

BooleanHolder get_power_etate = new BooleanHolder ( ) ; 

return_status = doGet Power State (get_power_state) ; 

f cm_server. get Power Stat eResp (sourceld, 
return_status, trans act ion_id, getjpowe restate . getvalue ( ) ) / 

i_replied = true; 

} 

break; 
// 

// SET_JPOWER STATE 
// = = === = = = ™ = = = = 

// 

case CoiistFcmOperationld . SET_POWER_STATE : 

{ 

f cm_se . log (f cm_se . MSG_INFO_HIGH , 
f cm_se.MSG_SEWDER_DCM / "FcmUpnp received SetPowerState" ) ; 

BooleanHolder set_power_state = new 

BooleanHolder (payload. readBoolean () ) ; 

return_status = do_SetPowerState ( set_power_state) ; 

fcm_server. setPowerStateResp (sourceld, 

return_status, transaction__id, s et_power_st at e . get Value ()) ; 

i_replied = true; 

} 

break; 
// 

// WINK 

// 

case Cons tFcmOperationld. WINK: 
{ 

fcm_se . log (f cm_se . MSG_INFO_HIGH, 
fcm_se.MSG_SENDER__DCM, "FcmUpnp received Wink") ; 

return_status = do_Wink(); 

f cm_server .winkResp (sourceld, return_status , 



trans act ion_id) ; 



i_replied - true; 

} 

break; 



// 

// UNWINK 
// 

// 

case CoiistFcmOperationld. UNWINK: 

{ 

f cm_se . log (f cm_se . MSG_INFO_HIGH, 
f cm_se.MSG_SENDER_DCM, "FcmUpnp received Unwink"); 

return_status = do_Unwink{) ; 

fern server .unwinkResp (sourceld, return_status , 



transaction id) ; 



i_ireplied ss true; 

} 

break; 
// 

// CAN_WINK 
// ======= = = 

// 

case CoiistFcmOperationld. CAN_WIN"K: 

{ 
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fcm__se . log (fcm_se . MSG_INFO__HIGH, 

fern se.MSG SENDER_DCM, "FcmUpnp received CanWink") ; 

~ ~~ " BooleanHolder can_i_wink = new BooleanHolder {) ; 

return_status = do_CanWink (can_i_wink) ; 

f cm_server . canWinkResp (sourceld, return_s tatus , 

trans act ion_id , can_i_wink . get Value ( ) ) ; 

i_replied = true; 

} 

break; 
// 

// GET_PLUG_COUNT 
// ============== 

// 

case ConstFcmOperat ionld . GET_PLUG__COUNT : 

f cm_se . log (f cm_se . MSG_INFO_HIGH, f cm_se . MSG_SENDER_DCM, 
"FcmUpnp received GetPlugCount") ; 

ShortHolder in_count = new ShortHolder ( ) ; 
ShortHolder out_count = new ShortHolder ( ) ; 
return_status - do_GetPlugCount (in__count , 

out_count) ; 

femserver .getPlugCountResp (sourceld, return_status, 
transaction_id, in_count . getValue { ) , out_count . getValue 0 ) ; 

i_replied = true; 

} 

break; 

// 

// GET_SUPPORTED_STREAMJTYPES 

// :, = = = = = == = = = ::: = =: = ,: = = = = = = 

// 

case ConstFcmOperationld . GET_SUPPORTED_STREAM_TYPES : 
f cm_se . log (f cm_se .MSG_INFO_HIGH, f cm_se . MSG_SENDER_DCM, 
"FcmUpnp received GetSupportedStreamTypes" ) ; 

short plug_jnum = payload. readShort ( ) ; 
int direction = payload. readint 0 r 
StreamTypeSeqHolder stream__types = new 

StreamTypeSeqHolder () ; 

return_status = do_Get Support edSt r e amType s {plug_num, 

direction, stream_types) ? 

f cm__server . getSupportedfi treamTypesResp ( sourceld, 
return_status , transaction_id, stream_types .getValue 0 ) ; 

i_replied - true; 

} 

break; 
// 

// GET_SERVICE_DESCRIPTIONS 
// 

case ConstFcmUpnpOperationld . GET_SERVICE__DE SCRIPT IONS : 
f cm_se . log ( f cm_se . MSG_INFO_HIGH, f cm_se . MSG_SENDER_DCM, 
"FcmUpnp received GetServiceDescriptions" ) ; 

{ 

IntHolder services = new intHolder { 0) ; 

return_status = do_GetServiceDescriptions (services) ; 

HaviByteArrayOutputStream buffer = new /B\ 
HaviByteArrayOutputStream () ; V§/ 

buff er .writelnt {services . getValue () ) ; 

f cm_se .msgSendResponse (sourceld, received_op_code , 
ConstTransf erMode .SIMPLE, return_status , buffer, transaction_id) ; 

i_replied = true; 
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} 

break; 
// 

// GET_JDEVICE_TYPE 
// 

case ConstFcmUpnpOperationid.GET_DEVICE_TYPE: 

f cm_se.log (fcm_se.MSG_INFO_HIGH, f cm_se . MSG_SENDER_DCM, 

"FcmUpnp received GetDeviceType" > ; 

StringHolder device_type = new StringHolder () ; 
return_status = do_GetDeviceType (device_type) ; 
HaviByteArrayOutput Stream buffer = new 

HaviByteArrayOutputStreamO ; 

buffer. writeHaviString (device_type .get Value () ) ; 
f cm_se .msgSendResponse (source Id, received_op_code, 
ConstTransf erMode . SIMPLE, return_status , buffer, transaction_id) ; 

i__replied = true; 

} 

break; 
// 

// GET_SERVICE_IITFORMATION_LIST 

// 

case 

ConstFcmUpnpOperationld . GET_SERVICE_INFORMATION_LIST : 

fcm__se.log(fcm_se.MSG_INFO_HIGH / fcm_se . MSG_SENDER_DCM, 
"FcmUpnp received GetServicelnf ormationList " ) ; 

{ 

int iservice = payload . readlnt { ) ; 
Vector service_inf ormations = new Vector (); 
return_status = 

do_GetServicelnf ormationList (iservice, s er vi ce_inf ormat ions ) ; 

HaviByteArrayOutput Stream buffer = new 

HaviByteArrayOutputStream ( ) ; 

buf f er . writelnt (service__inf ormations . size () ) ; 

if (service_in£ ormations . size () > 0) { 

for (int i=0 ; i<service_inf ormations . size () ; i++) 

{ 

( {Servicelnf ormat ion) service_inf ormations . elementAt ( i ) ) .marshal (buffer) ; 

} 

} 

fcm_se .msgSendResponse (sourceld, received_op_code , 
ConstTransf erMode . SIMPLE, return_status , buffer, transact ion_id) ; 

i_replied = true; 

} 

break; 

// 

// PERFORM_CONTROL_COMMAND 
// 

case ConstFcmUpnpOperationld . PERFORM_CONTR0L_C0MMAND : 
f cm_se . log (f cm_se . MSG_INF0_HIGH, f cm_se . MSG_SENDER_DCM, 
"FcmUpnp received Perf ormControl Command" ) ; 

{ 

String control_url - payload . readHaviString () ; 

String service_type - payload . readHaviString () ; 
String service__type_v = payload . readHaviString () ; 
String action = payload . readHaviString () ; 

int nvariables = payload . readlnt () ; 
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Vector command = new vector () ; 

Vector variable = new Vector 0 ; 

Vector return_argument - new Vector 0 ; 
Vector return__value = new Vector 0 ; 
if (nvariables > 0) { 

for (int i=0; i<nvariables ; i++) { 



command . addElement (pay load . readHaviString ( ) ) ; 



® 



variable . addElement (pay load . readHaviString ( ) ) ; 

} 

} 

if (sendControl Command {new URL (control_url ) , 
service_type, service_type_v, action, command, variable, return_argument , 
return_yalue) -- false) { 

return_status = new status (Cons tApiCode . FCM, 
ConstGeneralErrorCode.UNlDENTIFIED_FAILURE) ? 

} else { 

return_status - new Status (Cons tApiCode . FCM, 

Cons tGeneralErrorCode. SUCCESS) ; 

} 

HaviByteArrayOutput Stream buffer = new 

HaviByteArrayOutputStream ( ) ; 

if (return_argument . size ( ) != return_value . size ( ) ) { 
f cm_s e . log ( f cm_se . MSG_ERROR , 
f cm_se . MSG_SENDER_DCM, "FcmUpnp : : PERF0RM_C0NTR0L_C0MMAND : Mismatch vector 
size" ) ; 

buffer. writelnt (0) ; 
} else { 

buffer. writelnt (return argument . size () ) ; 
if (return_argument . size ( ) > 0) { 
String ret_string; 

for (int i=0;i<return_argument . size () ; i+ + ) { 
ret_string = 



(String) return_argument .elementAt (i) ; 
(String) return_value . elementAt (i) ; 

} 



buf fer . writeHaviString (ret_s tring) ; 
ret_string = 

buf fer. writeHaviString (ret_s tring) ; 



} 

} 

f cm_se .msgSendResponse (source Id, received_op_code , 
ConstTransf erMode . SIMPLE , return_status , buffer, transaction_id) ; 

i__replied = true; 

} 

break; 
// 

/ / PERFORM_DEVICE_VARIABLE_QUERY 
// 

case 

Cons tFcmUpnpOperat ionld . P E RF 0 RM_D E V I C E_VAR I AB LE_QUE R Y : 

fcm_se.log(fcm_se.MSG_JNFO_HIGH, f cm_se .MSG_SENDER_DCM, 
"FcmUpnp received Perf ormDeviceVariableQuery" ) ; 

{ 

String control_url 
payload. readHaviString () ; j> 

String variable__name = 

payload. readHaviString () ; 

StringBuffer return__value = new StringBuf f er ( ) ; 
if (queryDeviceVari able (new URL (control_url) , 
variable_name, return_value) == false) { 
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return_status = new Status (ConstApiCode . FCM, 
Cons tGeneralError Code . UHIDENTIFIED__FAILURE) ; 

} else { 

return_status = new Status (Cons tApiCode . FCM , 

ConstGeneralErrorCode . SUCCESS) ? 

} 

HaviByteArrayOutputStream buffer = new 

HaviByteArrayOutputStream { ) ; 

buffer . writeHaviString ( ret urn_va lue . toSt ring {) ) ; 
fcm_se .msgSendResponse (source Id, received_op_code , 
ConstTransf erMode . SIMPLE, return_status, buffer, trans act ionjLd) ; 

i_replied = true; 

} 

break; 
// 

// not yet implemented 
// 

default : 

/ / Received unknown command 

fcm^se . log (fcm_se . MSG_WARNING , f cm__se .MSG_SENDER_FCM, 
'•FcmUpnp :: FcmListener : Received unknown command 

(»+received_op_code.getOperationId() +") . Send ENOTIMPLEMENTED" ) ; 

f cm_se. msgSendResponse (sourcsld, receive d_op_code , 

ConstTransf erMode . SIMPLE , new Status (ConstApiCode . FCM, 
ConstGeneralErrorCode .NOT_I IMPLEMENTED) , new 
HaviByteArrayOutputStream () , transaction_id) ; 

break; 

} catch (Exception e) { 
e.printStackTrace {) ; 

fcm_se . log (f cm_se .MSG_WARNING, f cm_se ,MSG_SENDER_FCM, 
"FcmUpnp : : FcmListener : Sending response failed. Give up!"); 

} 

} 

return i_replied; 

} 

} 

// _ ===== - ======= == 

// 

// Methods for answering the incoming request. 

// (can be overloaded by the final FCM) 

// 
// 



// --- do_GetHuid --- 

Status do_GetHuid (HUIDHolder huid) 

{ 

Status return_status = null; 
try { 

// Default Return code 

return_status = new Status (ConstApiCode .FCM, 
ConstGeneralErrorCode .UNIDENTIF I ED_FAILURE) ; 

// Build the response 
huid. setValue (my_huid) ; 

return_status = new Status (ConstApiCode . FCM, 
ConstGeneralErrorCode . SUCCESS) ; 

} catch (Exception e) { 

fcm_se.log(fcm_se.MSG_WARNING, f cm_se . MSG_SENDER_FCM , 
"FcmUpnp: :do_GetHuid: Exception occured when building or sending the command"); 
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} 

return return_status ; 

} 

If do_GetDcmSeid 

Status do_GetDcmSeid(SEIDHolder seid} 

{ 

Status return__status - null; 
try { 

// Default Return code 

return_etatus = new Status (ConstApiCode . FCM , 
Cons tGeneralErrorCode.UNIDENTIFIED^FAi: LURE) ; 

// Build the response 
seid . setValue (my_dcm_seid) ; 

return_status = new Status (ConstApiCode . FCM, 
ConstGeneralErrorCode . SUCCESS) ; 

} catch (Exception e) { 

f cm_se . log (f cm_se . MSG_WARNING, f cm_se . MSG__SENDER_FCM, 
"FcmUpnp ; :do_GetDcmSeid : Exception occured when building or sending the 
command") ; 

} 

return return_status ; 

} 

// do_GetFcmType 

Status do_GetFcmType (IntHolder fcm_type) 
{ 

Status return_status = null; 
try { 

// Default Return code 

return_status = new Status (ConstApiCode . FCM , 
ConstGeneralErrorCode .UNIDENTIFIED_FAILURE) ; 

// Build the response 

f cm_type . setValue (getSof twareElementType () ) ; 

return_status = new Status (ConstApiCode . FCM, 
ConstGeneralErrorCode. SUCCESS) ; 

} catch (Exception e) { 

fcm_se . log (f cm_se . MSG_WARtTING, f cmje . MSG_SENDER_FCM, 
"FcmUpnp : :do_GetFcmType : Exception occured when building or sending the 
command" ) ; 

} 

return return_status; 

} 

// do_GetPowerState (Must be overloaded by the final Fern) » 

Status do GetPowerState (BooleanHoIder power_state) 

{ 

Status return_status = null; 
try { 

// Default Return code 

return_status = new Status (ConstApiCode . FCM, 
ConstGeneralErrorCode . UNIDENTIFIED_FAILURE) ; 

// Build the response 

return_status = new Status (ConstApiCode - FCM, 
ConstGeneralErrorCode . ETOT^IMPLEMEKTTED; ; 
} catch (Exception e) { 

f cm_se . log (f cm_se ,MSG_WARITING, f cm_se .MSG_SENDER_FCM / 
"FcmUpnp: : do_GetPowerSt ate : Exception occured when building or sending the 
command") ; 

} 

return return_status ; 

} 

// do_SetPowerState (Must be overloaded by the final Fern) 
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Status do_Set Powers tate (BooleanHolder power_state) 
{ 

Status return_status = null; 
try { 

// Default Return code 

return_status = new Status (ConstApiCode . FCM, 
ConstGeneralErrorCode .UNIDENTIFIED_FAILURE) ; 

// Ignore the requested state. Build the response 

return_status = new Status {ConstApiCode . FCM, 
ConstGeneralErrorCode . NOT_IMPLEMENTED) ; 
} catch (Exception e) { 

f cm_se . log (f cm_se . MSG_WARNING , f cm_se .MSG_SENDER_FCM, 
"FcmUpnp: :do_Set Powers tate: Exception occured when building or sending the 
command") ; 

} 

return return_status ; 

} 

// do_Wink 

Status do_Wink() 

{ 

Status return_status = null; 
try { 

// Default Return code 

retum_status = new Status (ConstApiCode . FCM, 
ConstGeneralErrorCode .NOT_IMPLEMENTED) ; 
} catch (Exception e) { 

f cm_se . log ( f cm_se . MSG_WARNING, fcm_se . MSG_SENDER_FCM , 
" FcmUpnp :: do_W ink : Exception occured when building or sending the command")/ 

} 

return return_status ; 

} 

/ / do__Unwink 

Status doJJnwinkO 

{ 

Status return_status = null; 
try { 

// Default Return code 

return_status = new Status (ConstApiCode . FCM, 
ConstGeneralErrorCode .NOT_IMPLEMENTED) ; 
} catch (Exception e) { 

f cmj3e , log (f cm_se . MS G_WARN I NG , f cmje . MSG_SENDER_FCM, 
"FcmUpnp: :do_Unwink: Exception occured when building or sending the command"); 

} 

return return_status ; 

} 

// do_CanWink 

Status do_CanWink (BooleanHolder can_wink) 

{ 

Status return_status ■ null; 
try { 

// Default Return code 

return_status = new Status (ConstApiCode. FCM, 
ConstGeneralErrorCode , UNIDENTI FI ED_FAILURE ) ; 

/ / Build the response 

can_wink . setValue ( false) ; 

return_status = new Status (ConstApiCode . FCM, 
ConstGeneralErrorCode . SUCCESS) ; 

} catch (Exception e) { 

f cm_se . log (f cm_se . MS G_WARN I NG , f cm_se . MSG_SENDER_FCM, 
"FcmUpno : : do_CanWink : Exception occured when building or sending the command"); 



24 



EP 1 355 485 A1 



return return_status ; 

} 

// ___ do__GetPlugCount (Not really implemented - must be done by the final 
FCM) 

Status do_GetPlugCount(ShortHolder in_count, ShortHolder out_count) 
{ 

Status return_status » null; 
try { 

in_count . setValue ( (short) 0) ; 
out_count.setValue ( (short) 0) ; 
// Return NOT IMPLEMENTED 

return_status = new Status (Const Api Code . FCM , 
ConstGeneralErrorCode .NOT__IMPLEMENTED) / 
} catch (Exception e) { 

f cm_se . log ( f cm_se . MSGJtfARNING, fcm_.se . MSG_SENDER_FCM, 
"FcmUpnp: :do_GetPlugCount : Exception occured when performing the request"); 

} 

return return_status; 

} 

// do__GetSupportedStreamTypes (Not really implemented - must be done by 

the final FCM) 

Status do_GetSupportedStreamTypes (short plug_num, int direction, 

StreamTypeSeqHolder stream__types) 

{ 

Status return_status = null; 
try { 

StreamType[] st = new StreamType [0 ] ; 
stream_types . setValue (st) ; 
// Return NOT IMPLEMENTED 

return__status - new Status (ConstApiCode . FCM, 
ConstGeneralErrorCode . NOT_IMPLEMENTED) ; 
} catch (Exception e) { 

f cm_se . log (fcm__se . MSG_WARNING , f cm_se . MSGJSENDER_FCM, 
"FcmUpnp: : do_Get Support edStreamType s : Exception occured when performing the 
request") ; 

} 

return return__status; 

} 

If do__GetServiceDescriptions 

Status do_GetServiceDescriptions (IntHolder services) 
{ 

Status return_status = null; 
try { 

services .setValue (service_list . size () ) ; 

return__status = new Status (ConstApiCode . FCM, ^Tj 
Cons t Genera 1 ErrorCode . SUCCESS ) ; 

} catch (Exception e) { 

f cm_se . log ( f cm_se . MSG_WARNING, f cm_se . MSG_SENDER_FCM, 
"FcmUpnp: : do_GetServic eDesc rip t ions : Exception occured when performing the 
request") ; 

} 

return return_status ; 

} 

// do_GetDeviceType 

Status do_GetDeviceType (StringHolder device_type) 

{ 

Status return_status = null; 
try { 

device_type. setValue (my_device_type) ; 
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return_status = new Status (Const ApiCode . FCM, 
Cons t Gene ralErr or Code . SUCCESS ) ; 

} catch (Exception e) { 

f cm_se . log ( f cm_se . MSG JfARKTING , f cmse . MSG_SENDER_FCM, 
"FcmUpnp : :do_GetDeviceType : Exception occured when performing the request") ; 

} 

return return_s tatus ; 

} 

// do_GetServiceInf ormationList 

Status do_GetServiceInf ormationList (int iservice, Vector 
service_inf ormations ) 

{ 

Status return_status = null; 
try { 

if (iservice+1 <= service_list . size () ) { 

Service Information [] service_inf ormation = 
( (ServiceDescription) service_list .element At (iservice) ) . getServicelnf ormationList 

(); , r 

if (service_inf ormation. length > 0) { 

for (int i=0 ; i<service_inf ormation. length; i++) { 

service_inf ormations. add (service_inf ormation [i] ) ; 

} 
} 

} , a 

return_status = new Status (Cons tApiCode .FCM, 

Cons tGeneralErrorCode .SUCCESS) ; 

} catch (Exception e) { 

fern se . log (f cm_se .MSG_WARNING, fcm_se . MSG_SENDER__FCM , 
"FcmUpnp: :do_GetServiceInf ormationList : Exception occured when performing the 
request") ; 

} 

return return_status ; 

} 

// _ .-„„™™ M 

// Additional Methods 

// 

// 

// 

// do_the_registration 

// This method does the registration at the Registry. It is assumed that all 

FCMs , 
// register the same elements. But they differ in the ATT_SE_TYPE, so this 

attribute 

//is created by a special method which should be overloaded by the final 

FCM. 

void do_the_registration () 

^ Vector attribute_list = new Vector (); // Contains all attributes 
Havi By teArrayOutput Stream hbaos ; 
org. havi .types .Attribute attribute; 
SEID my_seid; 

// Get own SEID 
try { 

my_seid = f cm_se . getSeid () ; 
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} catch (HaviGeneralException e) { 

f cm_se . log (f cm_se . MSG_ERROR, f cm_se . MSG_SENDER_FCM , 
"FcmUpnp: :do_the__registration ; Fetching SEID failed"); 

return; 

} 

// Build all attributes 

/ / Sof twareElementType 
try { 

hbaos = new HaviByteArrayOutputStream { ) ; 
hbaos. writelnt (getSof twareElementType {) ) ; 
attribute = new 

org. havi. types .Attribute (Const At tributeName . ATT_SE_TYPE, hbaos) ; 

attribute_list .addElement (attribute, clone () ) ,* 
} catch (Exception e) { 

f cm_se . log (f cmje . MSG_WARNING, f cm_se , MSG_SENDER_FCM, 
"FcmUpnp: :do_the_regist rat ion: Error when creating the sof twareElementType" ) ; 

* 

II Vendor ID 
try { 

hbaos = new HaviByteArrayOutputStream () ; 
my__vendor__id . marshal (hbaos) ; 
attribute = new 

org . havi . types . Attribute (Const At tributeName . ATT_VENDOR_ID , hbaos ) ; 

attribute_list . addElement (attribute . clone ( ) ) ; 

} catch (Exception e) { 

f cm_se . log (f cm_se . MSG_WARNIKTG, f cm_se . MSG_SENDER_FCM, 
"FcmUpnp: :do_the_registration: Error when creating the Vendorld"); 

} 

// HUID 

try { 

hbaos = new HaviByteArrayOutputStream () ; 
my_huid. marshal (hbaos) ; 
attribute = new 

org. havi. types. Attribute (Const At tributeName. ATT_HUID, hbaos) ; 

attribute_list. addElement (attribute. clone () ) ; 

} catch (Exception e) { 

f cm_se . log (f cmjse .MSG_WARNING, f cm_se . MSG_SENDER_FCM, 
•'FcmUpnp: :do_the_regis t rat ion: Error when creating the HUID"); 

} 

// Targetld - not yet implemented 
try { 

hbaos = new HaviByteArrayOutputStream () ; 
niy_target_ id. marshal (hbaos) ; 
attribute ~ new 

org. havi . types . Attribute (Const At tributeName . ATT_TARGET_ID, hbaos) ; 

attribute_list . addElement (attribute . clone ()) ; 
} catch (Exception e) { 

f cm_se . log (f cm_se . MSG_WARNING, f cm_se . MSG_SENDER_FCM, 
"FcmUpnp: :do_the_regis trat ion: Error when creating the Targetld"); 

} 

// Interfaceld - not yet implemented 
try { 

hbaos = new HaviByteArrayOutputStream ( ) ; 
hbaos . writeShort ( (int) my_interf ace_id) 
attribute = new 

org. havi. types. Attribute (Const At tributeName . ATT__INTERFACE__ID , hbaos) ; 

attribute__list . addElement (attribute . clone ( ) ) ; 
} catch (Exception e) { 
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f cm_se . log ( f cm_se . M S G_WARN I NG , f cm_se . MSG_SENDER_FCM, 
"FcmUpnp : : do_the_regi strati on : Error when creating the Interf aceld" ) ; 

} 

// DeviceClass 
try { 

hbaos = new HaviByteArrayOutputStream () ; 
hbaos .writelnt (my_device_class) ; 
attribute - new 

org. havi .types .Attribute (ConstAttributeName . ATT_DEVICE_CLASS , hbaos) ; 

attribute_list . addElement (attribute . clone ( ) ) ; 
} catch (Exception e) { 

f cm_se . log ( f cm_se . M S G_ W ARN I NG , f cm_se . MSG_SENDER_FCM, 
" FcmUpnp :: do_the_regi st rat ion ; Error when creating the DeviceClass"); 

} 

// DeviceManuf acturer 
try { 

hbaos = new HaviByteArrayOutputStream { ) ; 
hbaos .writeHaviString (my_device_manuf acturer) ; 
attribute = new 

org . havi . types . Attribute { ConstAttributeName . ATT_DEVTCE_MANUF , hbaos ) ; 

attribute_list . addElement (attribute . clone ( ) ) ; 
} catch (Exception e) { 

fcm_se . log ( £cm_se . MS G_WARN I NG , f cm__se . MSG_SENDER_FCM, 
"FcmUpnp: :do_the_regi st rat ion: Error when creating the DeviceManuf acturer ") ; 

} 

// Sof twareElementVersion 
try { 

hbaos = new HaviByteArrayOutputStream (4) ; 
byte [] se_version = new byte [4] ; 
se_version [0] =0 
se__version [1] =1 
se_version [2] =0 
se_version [3] =0 
hbaos .write (se_version) ; 
attribute = new 

org. havi .types .Attribute (ConstAttributeName . ATT_SE_VERS , hbaos) ; 

attribute_list .addElement (attribute . clone {) ) / 
} catch (Exception e) { 

f cm_se . log ( f cm_se . MS G_W ARN I NG , f cm_se . MSG_SSNDER_FCM, 
"FcmUpnp: :do__the_regis trat ion : Error when creating the Sof twareElementVersion" ) ; 

} 

// UserPref erredName 
try { 

hbaos - new HaviByteArrayOutputStream { ) ; 
hbaos .writeHaviString (my_user_j3ref erred_name) ; 
attribute = new 

org .havi . types . Attribute (ConstAttributeName . ATT_US E R_PRE F_NAME , hbaos) ; 

attribute_list .addElement (attribute . clone () ) ; 
} catch (Exception e) { 

fcm_se. log (f cm_se.MSG_WARNING, f cm_se .MSG_SENDER_FCM r 
"FcmUpnp: : do_the_regis trat ion: Error when creating the UserPref erredName" ) ; 

} 

if (getDdiCapability ( ) -= true) { 
try { 

hbaos = new HaviByteArrayOutputStream () ; 
hbaos . writelnt (ConstGuiReq. DDI_GUI) ; 
attribute = new 

org. havi . types .Attribute (ConstAttributeName . ATT_GUI_REQ , hbaos) ; 

attribute_list .addElement (attribute . clone 0 ) ; 
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} catch (Exception e) { 

f cm_se . log ( f cm_se . MSGJWARNING, fcm_se . MSG_SENDER_FCM, 
"FcmUpnp: : do_the_registration : Error when creating the GuiReq") ; 

} 

} 

// Build the AttributeList 

erg. havi .types. Attribute attributes!] = new 
org. havi .types .Attribute [attribute_list . size () ] ; 

for (int i=0;i<attribute_list.size() ;i++) { 

attributes [i] = ( org. havi . types .Attribute) attribute_list . elementAt (i) ; 

} 

// Do the registration 
try { 

RegistryLocalClient reg = new RegistryLocalClient (fcm_se) ; 
reg. registerElementSync (10000, my_seid, attributes ) ; 
} catch (Exception e) { 

f cm_se . log (f cm__se .MSG_WARNING, f cm_se .MSG_SENDER_FCM / 
"FcmUpnp: :do_the_regi st rat ion: Registration failed"); 

} 

} 

// 

// getSoftwareElementType 

// This method provides the Sof twareElementType for the methods 
// do_the_regi strati on [) and get_f cm_type_received ( ) . 
// This method should be overwritten by the final FCM! 
// 

int getSof twareElementType () 

{ 

return ConstSof twareElementType .GENERIC_FCM; 

} 



// 

// getDdiCapability 
// .............. 

// This methods returns true if the FCM is DDI capable or false if it is 

not . 

// The method shall me overwritten by the final FCM. 
boolean getDdiCapability ( ) 

{ 

return false; 

} 

// 

// sendControl Command 
// ================== 

// A UPnP control command is sent to an UPnP device. 

boolean sendControl Command (URL url, String service_type, String 
service_type_v, String action_name, Vector in_argument_names / Vector 
in_argument_values , Vector out_argument_names , Vector out_argument_values) 

{ 

boolean ret_value = true; 
try { 

// Build the body of the SOAP Message 

By teArrayOutput Stream baos_body = new ByteArrayOutputStream { ) ; 
baos_body. write ( (new String ( "<s : Envelope \r\n" ) ) .getBytesO) ; 
baos_body. write ( (new String ( " 
xmlns :s=\"http://schemas.xmlsoap.org/soap/envelope/\ 1 '\r\n M > ) .getBytes () ) ; 
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baos_body .write ( (new StringC 
s : encodingStyle=\ "http : / /schemas . xmlsoap . org/ soap/encoding/ \ " >\r\n" ) ) . getBytes { ) 

) ; 

baos_body .write ( (new String(" <s :Body>\r\n" ) ) .getBytes()J ; 
baos_body .write ( (new StringC <u: "+action_name+" 
xmlns :u=\"urn: schema s-upnp - 

org: service: " + service___type+" ; " + service__type_y+ 11 \ " >\r\n" ) ) .getBytes () ) ; 

if (in_argument_names . size () != 0) { 

if (in_argument__names . size () != in_argument values . size ( ) ) { 
fcm__se. log (f cm_se . MSG_WARNING, f cm_se .MSG_SENDER_FCM, 
"FcmUpnp : : sendControlCommand: Mismatch in vector lenghth of in_argument_names 
and in_argument_values ! " ) ; 

} else { 

for (int i=0 ; i<in_argument_names . size ( ) ,- i++] { 
baos_body. write ( (new String (" 
<" + (String) in_argument_names . element At (i) +">"+ (String) in_argument_values . element 
At (i) +"</"+ (String) in_argument_names . elementAt (i) +">\r\n") ) .getBytes () ) ; 

} 

} 

} 

baos_body .write ( (new StringC 
</u: ,, +action_name+">\r\n") ) .getBytes () ) / 

baos_body. write ( (new StringC </s : Body>\r\n" )). getBytes ()) ; 
baos__body. write ( (new String ( 11 </s : Envelope >\r\n" ) ) .getBytes ()) ; 

// Build the header of the SOAP message 

ByteArrayOutputStream baos_header = new ByteArrayOutputStream ( ) ; 

baosjheader. write ( (new String ( " POST "+url . getFile () +" 
HTTP/1 . l\r\n") ) . getBytes ()) ; 

baos_header. write ( (new String ( "HOST : 
»+url .getHost () +" : "+url .getPort ( ) +" \r\n" ) ) .getBytes () ) ; 

baos__header. write ( (new String ( 11 CONTENT -LENGTH : 
"+baosJbody . toByteArray () . length*" \r\n n ) ) . getBytes () ) ,- 

baos_header .write ( (new String ( "CONTENT- TYPE : text/xml; 
charset = \"utf-8\ l, \r\n") ) .getBytes () ) ; 

baos_header. write ( (new String (" SOAPACTION : V'urn: schema s-upnp- 
org : service : "-i-service_type+ " : 11 + service_type_v+ " #" +action_name+" \ 11 \r\n" ) ) . getByte 
s()); 

baos_header .write ( (new String (" \r\n" ) ) .getBytes () ) ; 
//System. out .println (baosjheader . toString ( ) ) ; 
// System. out .println (baos__body. toSt ring () ) ; 

// Create the Socket for the connection to the device 
Socket sock = new Socket (url .getHost () , url .getPort () ) ; 
sock.setSoTimeout (3 00 00) ; 

OutputStream out = sock.getOutputStreamO ; 
InputStream in = sock. get Inputs tream() / 

// Send the Command 

out . write (baos_header . toByteArray ( ) ) ; 
out .write (baos__body. toByteArray () ) ; 

// Read the Response 
try { 

int len; 

byte b[] = new byte [100]; 
StringBuffer sb = new StringBuf f er () ; 
while ((len = in.read(b)) != -1) { 
sb . append (new String (b, 0, len) ) ; 

} 

StringTokenizer st - new StringTokenizer (sb . toString ( ) , "\n"); 

/ / Check for correct header 

if (st . hasMoreElements ( ) == true) { 
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String header_line_l = s t . nextToken ( ) . trim ( ) ; 
if {header_line_l. equals ("HTTP/ 1.1 200 OK" ) == false) { 
fcm_se >log(f cm_se.MSG_WARNING, f cm_se . MSG__SENDER_FCM, 
"FcmUpnp: : sendControlCommand: Received wrong header in response from the UPnP 
device: "+header_line_l) ; 

ret_value = false; 
} else { /rs 
if Skip the rest header N-ll 
while (st.hasMoreElements () == true) { y ^ 
if (st. nextToken () .trimO .length 0 == 0) break; 

} 

// Read the body 

StringBuffer sbe = new StringBuf f er ( ) ; 
while (st.hasMoreElements () == true) { 

sbe . append ( s t . nextToken ( ) . trim { ) + " \n 11 ) ; 

} 

//System. out .println ("Response \n"+sbe . toStringO ) ; 

// Create an XML element for the body 
SAXBuilder builder = new SAXBuilder () ,- 
Document doc = builder . build (new 
EyteArraylnput Stream (sbe. toStringO .getBytes 0 ) ) ; 

// Fetch root element and Namespace 

Element root = doc . getRootElement () ; 

if (root null) { 

f cm_se . log ( f cm_s e . MS G_ WARN I NG , 
f cm_se.MSG_SENDER_FCM, "FcmUpnp :; sendControlCommand : Didn't find root 
element ! " ) ; 

throw new 

HaviUnidentif iedFailureException (ConstApiCode . FCM) ; 

} 

Namespace ns = root .getNamespace ( ) ; 
// Fetch the body element 

Element body = root . getChild ( "Body 11 , ns) ; 

if (root == null) { 

f cm_se . log (f cm_se .MSG_WARNING, 
f cm__se.MSG_SENDER_FCM, "FcmUpnp :: sendControlCommand : Didn't find body 
element ! " ) ; 

throw new 

HaviUnidentif iedFailureException (ConstApiCode . FCM) ; 

} 

// Fetch response 

List response_list = body .getChildren ( ) ? 

if (response_list. size () != 1) { 
f cm_se . log ( f cm_se . MSG__WARNING , 
fcm_se.MSG_SENDER_FCM, "FcmUpnp :: sendControlCommand : Wrong number of children in 
body! 11 ) ; 

throw new 

HaviUnidentif iedFailureException (ConstApiCode . FCM) ; 

} 

Element response = (Element) response_list .get (0) ; 

if (response. getName () .equals (action_name+"Response " ) == 

false) { 

f cm_se , log (f cm_se . MSG_WARNING , 
fcm_se.lY[SG_SENDER__FCM, "FcmUpnp :: sendControlCommand : Didn't find child with name 
"+action__name+ "Response 1 " ) ; 

throw new 

HaviUnidentif iedFailureException (ConstApiCode . FCM) ; 

} 

// Fetch the Out -Parameters 
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List parameter_list = response . getChildren () ; 
if (parameter_list . size () > 0) { 

for (int i = 0 ; i<parameter_list . size 0 ; i++) { 
Element parameter = 

(Element )parameter_li st . get (i) ; 

out_argument_names .addEletnent [parameter . getName 0 ) ; 
out argument_values . addElement (parameter . getText ( ) ) ; 

} 

} 

} 

} catch (java . io. lOException ex) { 

fcm_se . log (f cm_se . MSG_WARNING, f cm_se . MSG_SENDER_FCM, 
"FcmUpnp : : sendControl Command: Didn't receive a response from the UPnP 
device! ! ! ") ; 

ret_value = false; 
} catch (org. jdom. JDOMException e) { 
e .printStackTrace [) ; 

f cm_se . log (f cm_se . MS G__W ARN I NG , f cin_se . MSG_SENDER_FCM , 
"FcmUpnp : : sendControl Command : JDQMException ! " ) ; 

ret_value = false; 
} catch (HaviUnidentif iedFailureException ex) { 
ret_value = false; 

} 

// Close streams and socket 
in. close () ; 
out . close { ) ; 
sock -close ( ) ; 

} catch ( java.net .UnknownHost Except ion e) { 

f cin_3e . log (f cm_se . MS G_WARN ING , f cm_se . MSG__SENDER_FCM, 
"FcmUpnp :: sendControlCommand: Host is unknown!"); 

ret_value = false; 
} catch ( j ava . net . SocketException e) { 

f cm_se . log (f cm_se . MSG__WARNING, f cm_se . MSG_SENDER_FCM, 
» FcmUpnp : : sendControlCommand : Socket Except ion ! " ) ; 

ret_value = false; 
} catch (java. io. IOException ex) { 

f cm_se . log (f cm_se . MS G_WARN ING , f cm_se . MSG_SENDER_FCIVI / 
" FcmUpnp : : sendControlCommand : IOExcept ion ! " ) ; 

ret__value = false; 

} 

return ret_value; 

} 

boolean sendControlCommand (URL url, String service_type , String 
service_type_v / String actionjiame, String argument_name, String argument_value) 

{ 

Vector argument_names = new Vector ( ) ; 
Vector argument_values = new Vector (}; 
argument_names . addElement (argument_name) ; 
argument_yalues . addElement (argument_value) ; 

return sendControlCommand (url , service_type , service_type_v, 
action_name, argument_name s , argument_values , new Vector (), new Vector () ) ; 

} 

boolean sendControlCommand (URL url, String service_type , String 
service_type_v, String action_name) 

{ 
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return sendControl Command (url , service_type, service_type_v, 
action_name, new Vector (), new Vector (), new Vector {), new Vector!)]; 

} 

// 

// que ryDeviceVari able 

//A variable of an UPnP device is queried. 

boolean queryDeviceVariable (URL url, String variable_name , StringBuffer 
return_value ) 

{ 

boolean ret_value = true; 
try { 

// Build the body of the SOAP Message 

ByteArrayOutputStream baos — body = new ByteArrayOutputStream ( } ? 

baos_body. write ( {new String ("<s : Envelope\r\r." ) ) .getBytesO ) ; 

baos_body . write ( (new String ( " 
xmlns :s = \ ,, http://sche^Tlas.xmlsoap.org/soap/envelope/\"\r\n ,, ) } .getBytes {) ) ? 

baos_body . write ( (new String ( 11 
s :encodingStyle=\"http: //schemas . xmlsoap.org/ soap/encoding/ \»>\r\n») ) .getBytes { ) 

); 

baos_body. write ( (new String (" <s : Body>\r\n" ) ) .getBytes () ) ; 

baos_body. write ( (new String{" <u ; QueryStateVariable 
xmlns :u=\ "urn: schemas -upnp-org : control - 1- 0\ ">\r\n" ) ) .getBytes () ) ; 

baos_body. write ( (new String(" 
<u:varName>"+variable_name+"</u :varName>\r\n" ) ) .getBytes () } ; 

baos_body . write ( (new String{" 
</u:QueryStateVariable>\r\n") ) .getBytesO) ; 

baos_body . v/rite ( (new String{" </s :Body>\r\r_" )) .getBytes ()) ; 

baos__body. write ( (new String ( "</s :Envelope>\r\n" ) ) .getBytes () } ; 

// Build the header of the SOAP message 

ByteArrayOutputStream baos_header = new ByteArrayOutputStream ( ) ; 
baos_header .write ( (new String ( "POST Hurl .getFile () +" 

HTTP/l . l\r\n" ) ) .getBytes () ) ; 

baos_header . write ( (new String ( " HOST : 
"+url .getHost () + " : " +url . getPort ( ) +"\r\n") ) .getBytes () ) ; 

baos_header .write ( (new String ( "CONTENT -LENGTH : 
"+baos_body. toByte Array () . lengths " \r\n") ) .getBytesO); 

baos_header . write ( (new String { "CONTENT- TYPE : text/xml; 
charset=\ ,, utf-8\ n \r\n") ) .getBytes 0 ) ; 

baos_header .write ( (new String ( "SOAPACTION: \ "urn : schemas -upnp- 
org: control- l-0#QueryStateVariable\ "\r\n" ) ) .getBytes () ) ; 

baos_header .write ( (new string ( n \r\n n ) ) .getBytesO ) ; 

/ /System. out . println (baos_header . toString ( ) ) ; 

//System. out .print In (baos_body , toString ( ) ) ; 

// Create the Socket for the connection to the device 
Socket sock = new Socket (url . getHost () , url .getPort () ) / 
sock . setSoTimeout (30000) ; 

Output Stream out = sock. getOutput Stream ( ) ; 
Inputs tream in = sock . get InputStream ( ) ; 

// Send the Command 

out .write (baos_header . toByteArray () ) / 
out. write (baos__body . toByteArray () ) ; 

// Read the Response 
try { 

int len; 

byte b[] = new byte [100]; 
StringBuffer sb = new StringBuf f er () ; 
while (den = in. read (b) ) != -1) { 
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sb . append { new String (b, C , len) ) ; 
//System, out . println ( "Response : \n n 4-sb) ; 

StringTokenizer st = new StringTokenizer (sb . toString { ) , "\n"); 

// Check for correct header 

if (st.hasMoreElements () — true) { 

String header_line_l = st . next Token ( ) . trimO ; 
if (header_l ine_l. equals ("HTTP/1. 1 200 OK") == false) { 
f cm_se . log (f cm__se . MSGJWARNING, f cm_se . MSG_SENDER_FCM, 
"FcmUpnp: : queryDeviceVariable : Received wrong header in response from the UPnP 
device: "+header_line_l) ; 

ret_value = false; 
} else { 

// Skip the rest header 

while (st .hasMoreElements () »= true) { 

if (st.nextTokenO .trimO . length () == 0) break; 

} 

// Read the body 

StringBuffer sbe = new StringBuf f er { ) ; 
while (st .hasMoreElements () == true) { 

sbe . append (st .next Token ( ) . trim () + n \n" ) ; 

} 

// Create an XML element for the body 
SAXBuilder builder = new SAXBuilderO ; 
Document doc = builder .build (new 
ByteArraylnputStream (sbe. toString () .getBytes () ) ) ; 



® 



// Fetch root element and Namespace 
Element root = doc .getRootElement ( ) ; 
if {root == null) { 

f cm_se . 1 og ( f cm_se . MSG_WARNING , 

f cmse , MSG_SENDER_FCM , " FcmUpnp : : queryDeviceVariable : Didn 1 t find root 

element ! ") / 

throw new 

HaviUnidentif iedFailureException ( Con stApi Code . FCM) ; 

} 

Namespace ns = root .getNamespace ( ) ; 

// Fetch the body element 

Element body ■ root .getChi Id ( "Body" , ns) ; 

if {body null) { 

fcra_se . log ( f cm_ s e . MSG_WARN ING , 

fcm_se.MSG_SENDER_FCM, " FcmUpnp queryDeviceVariable : Didn't find body 

element ! " ) ; 

throw new 

HaviUnidentif iedFailureException (ConstApiCode . FCM) ; 

} 

f I Fetch the response 

List response_list = body . get Children () ; 

if {response_list . size () != 1) { 
f cm_se . 1 og ( f cm__s e . MSG_WARN ING , 
fcm_se.MSG_SENDER__FCM, "FcmUpnp :: queryDeviceVariable : Wrong number of children 
in body ! " ) ; 

throw new 

HaviUnidentif iedFailureException (ConstApiCode . FCM) ; 

} 

Element response = (Element) response_list .get (0) ; 
if 

(response . getName 0 . equals ( "QueryStateVariableResponse" ) == false) { 
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f cm_se. log (f cm_se . MSG_WARNING, 
f cm_ss . MSG__SENDER_FCM, "FcmUpnp : : queryDeviceVariable : Didn't find 
QueryStateVariableResponse element!") ; 

throw new 

HaviUnidentif iedFailureException (ConstApiCode , FCM) ; 

} 

// Fetch the return value 

List return_list = response , getChildren () ; 

if (return__list . size {) != 1) { 

f cm_se . log (f cm_se . MSG_WARNING , 
f cm_se . MSG_SENDER_FCM, "FcmUpnp :: queryDeviceVariable : Wrong number of children 
in body I " ) ; 

throw new 

HaviUnidentif iedFailureExcept ion (ConstApiCode . FCM) ; 

} 

Element returnv - (Element ) return_list . get (0 ) ; 

if ( returnv. ge tName () .equals ("return") == false) { 
f cm_se . log (f cm_se . MSG_WARNING, 
f cm_se.MSG_SENDER_FCM, "FcmUpnp :: queryDeviceVariable ; Didn't find child with 
name \"return\" ! ") ; 

throw new 

HaviUnidentif iedFailureException (ConstApiCode . FCM) ; 

} 

// Fetch the Out -Parameters 
return_value . append ( returnv . get Text ( ) ) ; 

} } 

} catch ( java . io . IOException ex) { 

f cm_se . log (f cm_se . MSG_WARNING, f cm_se .MSG_SEKTDER_FCM, 
"FcmUpnp : :queryDevice Variable : : Didn't receive a response from the UPnP 
device ! ! J " ) ; 

ret_value = false; 
} catch (org. jdom . JDOMException e) { 
e .printStackTrace { ) ; 

f cm_se . log (f cm_se . MS G_W ARN I NG , f cm_se .MSG_SENDER_FCM, 
" FcmUpnp : : queryDeviceVariable : : JDOMException ! » ) ? 

ret_value = false; 
} catch (HaviUnidentif iedFailureException ex) { 
ret_value = false; 

} 

// Close streams and socket 
in. close () ; 
out . close () ; 
sock. close {) ; 

} catch ( j ava . net .UnknownHostException e) { 

f cm_se. log (f cm__se .MSGJtfARNING, f cm_se.MSG_SENDER_FCM / 
"FcmUpnp: : queryDeviceVariable : : Host is unknown! ") ; 

ret_value = false; 
} catch ( j ava . net . SocketException e) { 

fcm_se. log(fcm_se.MSG_WARNING, f cm_se .MSG_SENDER_FCM, 
"FcmUpnp: : queryDeviceVariable : : SocketException! ") ; 

ret_value = false; 
} catch (j ava , io . IOException ex) { 

f cm_se. log (f cm_se .MSG_WARNING, f cm_se .MSG_SENDER_FCM, 
"FcmUpnp: : queryDeviceVariable : : IOException! ") ; 

ret_value = false; 

} 

return ret_value; 
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// 

// receiveHttpNotif yData 

// 

// 

// This method is called by the UpnpWebServer when an event notification is 

received from the 

// device where this FCM subscribed for EventNotif ication . 

// 

public void receiveHttpNotif yData (String [] header, InputStream data, 
Output Stream response) 

{ 

// Variables 

int content_length - -l; 

String http_response_header__success = new String ( "HTTP/1 . 1 200 OK" ) ; 
String http_response_header ^ new 

String (http_response__header_success) ; 

// Read the Header first 
try { 

//for (int i=0; i<header . length; i++) 
System. out .print In ("FcmUpnp: receiveHttpNotif yData received header: "+header [i] ) ; 

// Search for the content length 
for (int i=0 ; i<header . length; i++) { 

StringTokenizer st = new StringTokenizer (header [i] ,":") ; 
if {st .hasMoreTokens {) == true) { 

if (st .nextToken () ,trim() . equal s ignore case ( "content -length " ) 

= = true ) { 

content_length = 
Integer .parselnt (st .nextToken () . trim()) ; 

} 

} 

} 

if (content_length == -1) { 

// The header doesn't contain the CONTENT LENGTH 

http_responseJieader = new String ( "HTTP/l . 1 412 Missing CONTENT - 

} 

if (http__response_header . equals (http_response_header_success) == 



LENGTH" ) ; 



true) { 

// Read the XML description of the action 
byte[] bdata - new byte [content_length] ; 
data . read (bdata) ; 

{ 

// Overwrite added zeros with LFs . Evidently bug in AXIS 

implementat ion 1 

for (int pos=bdata. length- 1 ; bdata [pos] == 0;pos--) 

bdata [pos] =0x0 A; 

} 

HaviByteArraylnputStream bais = new 
HaviByteArraylnputStream (bdata) ; 

SAXBuilder builder = new SAXBuilder ( ) ; 
Document doc = builder . build (bais ) ; 

// Fetch the root element 

Element root = doc ,getRootElement ( ) ; 

if (root == null) { 

Sof twareElement . log (Sof twareElement .MSG__WARNING/ 
"FcmUpnp . receiveHttpNot if yData () : No root element found! Give up!"); 

throw new HaviUnidentif iedFailureException { (short) 0) ; 

} 



® 
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// Check the namespace 

if (root .getNamespace 0 .getURlO . equal slgnoreCase ( "urn: s enemas - 
upnp - org : event -1-0 " ) == false) { 

Sof twareElement . log (Sof twareElement .MSGJWARNING, 
"FcmUpnp.receiveHttpNotifyDataO : Wrong namespace: 

>"+root .getNamespace () .getURI () +"< instead of >urn : schemas -upnp- org : event - 1 - 0 < ! 
Give up 1 " ) ; 

throw new HaviUnidentif iedPailureException ( (short) 0) ; 

} 

// Fetch all propertys 

java.uti 1 , List propertys = rooz .getchildren ( ) ; 
for (int j=0; j<propertys . size () ; j++) { 

Element property_element = (Element) propertys . get (j ) ; 

// Fetch the variable 

java.util.List variables = property_element . get Children () ; 
for (int j j=0; j j<variables. size () ; j j++) { 

Element variable_element = (Element ) variables . get (j j ) ; 

System. out. println ("Variable 

"+variable_element .getName () +" " +variable_element . getText ( ) ) ; 

} 

} 

} 

} catch (Exception ex) { 

Sof twareElement . log ( Sof twareElemen- . MSG_WARNING, 
"FcmUpnp.receiveHttpNotifyDataO : Exception occured when intepreting the 
data! ") ; 

ex. print StackTrace ( ) ; 

http_response_header = new String ( "HTTP/ 1 . 1 500 Internal Server 

Error") ; 

} 

// Build the complete response, 
try { 

// Build the header of the SOAP message 

ByteArrayOutputStream baos_header = new By teArrayOutput Stream ( ) ; 

baos_header . write ( (new 
String (http_response__header-f- , '\n\r ,l ) ) .getBytes 0 ) ; 

baos_header . write ( (new String ( "\r\n" ) ) . getBytes ( ) ) ; 

response .write (baos_header . toByteArray ( ) ) ; 
} catch ( j ava . io . lOException ex) { 

Sof twareElement . log (Sof twareElement . MSG_WARNTNG , 
"FcmUpnp.receiveHttpNotifyDataO : Exception occured when building the 
response ! " ) ; 

ex .printStackTrace 0 ; 

} 

} 

// 
// 

// Additional Methods (possibly overloaded} 

// —————— 

// 
// 



// 

// getDevicePath 
// ============= 

// 

// The root device path for storing information on this device at the 
webserver is returned. 



37 



EP 1 355 485 A1 



// This method must be overloaded. 

// 

String getDevicePath ( ) 
{ 

try { 

StringBuf f er sb=new StringBuf fer () ; 
byte[] seid = fcm_se.getSeid() .getValue () ; 
for (int i=0 ; i<seid . length; { 

int v= (int) seid [i] ; 

if (v < 0) v+=256; 

String hstring = Integer . toHexString (v) ; 
if (hstring. length () ==2) { 

sb . append (hstring) ; 
} else { 

sb. append ( "0"+hstring) ; 

} 

} 

return "/upnp/ "+sb . toString () . toUpperCase ( ) ; 
} catch (Exception ex) { 

return " /upnp/undef inedguid " ; 

} 

} 

// 

// getUpnpEventNotif icationPath 
// ============================ 

// 

// The path to which event notifications are sent by the according UPnP 
device . 

// 

String getUpnpEventNotif icationPath ( ) 

return getDevicePath () +"/event_notif ication" ; 

} 

} 



Fig. 4 
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// Copyright (c) 2000-2001, This software is the property of Thomson 
// multimedia, and shall not be reproduced, copied, or distributed 
// without written permission. 

// 

// 

// TITLE: HavletUpnpDevice - Implementation of the HavletUpnpDevice 

class . 

// AUTHOR (s) : Ingo Huetter 

// DATE CREATED: 28. September 2 001 

// FILENAME : HavletUpnpDevice . j ava 

// PROJECT: DHN (HAVi implementation) 

// COPYRIGHT: (C) 2000-2001 THOMSON multimedia, 

// THIS SOFTWARE IS THE PROPERTY OF THOMSON multimedia, AND SHALL NOT 
// BE REPRODUCED, COPIED, OR DISTRIBUTED WITHOUT WRITTEN PERMISSION. 

// 

// VERSION: 1.1 
// 

// MODIFICATION HISTORY: 

// DATE MODIFIED: 

// AUTHOR (s) : 

// MODIFICATION MADE: 

// PROBLEM CAUSING MODIFICATION: 

// 

// DESCRIPTION: 

// The HavletUpnpDevice creates a graphical UI based on the XML description of 
the device. 

// Information on services are retrieved from the FCM using a proprietary API. 
// 

// NEEDED RESOURCES: 

// The following classes and images are needed by this havlet, so the 

// according files must be packed into the jar file. 

// - com. thmulti .havi .havlet .HavletBitmapComponent 

// - com. thmulti .havi .havlet .HavletResource 

// - com. thmulti .havi .util .BackgroundMosaicWindow 

// - com. thmulti .havi .util .TPanel 

// - com. thmulti .havi .upnp .HavletUpnpDevice 

// - com. thmulti , havi .upnp. Const FcmUpnpOperationld 

// - com. thmulti . havi .upnp .Service Information 

// - com.thmulti.havi.upnp.upnp_logo.gif 

// 

package com . thmulti . havi . upnp ; 

import org. havi . constants . * ; 
import org . havi . type s . * ; 
import org. havi . system. * ; 
import j ava . awt . * ; 
import j ava . awt . event . * ; 
import j ava. lang. reflect . * ; 
import j ava, ut il .vector ; 

import com. thmulti . havi . util . BackgroundMosaicWindow ; 
import com. thmulti . havi . util . TPanel ; 

import com. thmulti . havi . havlet . HavletBitmapComponent ; 
import com. thmulti . havi . havlet .HavletResource ; 

public class HavletUpnpDevice 

{ 

// Variables 

HavletListener hv__listener ; 

SoftwareElement hv_se; 

OperationCode hv_event_opcode; 

UninstallationListener hv ul ; 
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EventManagerLocalClient em; 

DcmClient dcm_client ; 

Window win = null; 

SEID dcm_seid; 

SEID fcm_seid; 

SEIDSeqHolder fcm_seids; 

int window__height ; 

int window_width ; 

int private_log_method_available = -1; // -1 unknown, 0 
no, 1 yes 

Method private__log_method = null; 

Panel sp_panel; 

HavletThread havlet_thread; 

// Constructor 

public HavletUpnpDevice () 

{ 
} 

// install 

public int install (SEID source, UninstallationListener listener) 

{ 

// Save the parameters 
hv_ul = listener; 
dCTi_3cid = source; 

// Create the listener and the software element 
try { 

hv_listener = new HavletListener ( ) ; 
hv_se = new Sof twareElement (hv_listener) ; 

} catch (Exception e) { 

log ( "ERROR" , "HavletUpnpDevice :: install ; Creating hv_listener or 

hv_se failed! "} ; 

return 1; 

} 

// Retrieve the SEID of the FCM(s) 
try { 

dcm__client = new DcmClient (hv_se, dcm_seid) ; 
fcm_seids = new SEIDSeqHolder {) ; 

dcm_client . getFcmSeidListSync (3 000, fcm_seids) ; 
} catch (Exception e) { 

log ( "WARNING" , "HavletUpnpDevice :: install : Exception when retrieving 
the list of FCMs in DCM" ) ; 

return 1; 

} 

/ / Start the Thread for building the UI 
havlet_thread = new HavletThread ( "HavletThread" ) ; 
havlet thread . start () ; 



log("INFO_HIGH», "HavletUpnpDevice: : install: finished") ; 
return 0 ; 

} 

// uninstall 

public void uninstall () 

{ 

// Unregister from the MessagingSystem 
try { 

hv_se . close ( ) ; 
} catch (Exception e) { 
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log ( "WARNING" , "HavletUpnpDevice : :uninstall : Unregistrat ion from 
MessagingSystem failed"); 

} 

win. setvisible (false) ; 

if (win != null) win . dispose () ; 

if (hv_ul != null) { 

hv_ul . unins tailed () ; 

} 

log ( " INFQ_HIGH" , "HavletUpnpDevice was uninstalled") ; 

} 

// 
// 

// HavletListener 
// ———«--- 

// (the receiveMsg method is called when a message for the Havlet arrives 

// 
// 

public class Havletliistener 
extends HaviListener 

{ 

public HavletListener ( ) throws HaviGeneralException 

{ 
} 

public boolean receiveMsg (boolean haveReplied, byte protocolType , SEID 
sourceld, SEID destld, Status state, HaviByteArraylnputStream payload) 

{ 

boolean i_replied = false; 

if (state .getApiCode () == Cons tApi Code . MSG && state .getErrorCode ( ) 
— : Cons tGeneral Error Code. PRINT_SYSTEM_STATUS ) { 

try { 

log("INFO_HIGH" , 

log ( "INFO_HIGH" , "======= System/Status information 

HavletUpnpDevice - SEID "+hv_se .getSeid ( ) ) ; 

log ( " INFO_HIGH " , 

,, ==:= = = == = = = = = = = = = = = = = = = := = = ==:=: = =: = =:=: = = = = = = = = = = = = = :=S : SS = =! = = == = ==== = = = ==: : =====") ; 

} catch (HaviGeneralException ex) { 

} 

} else { 

log ( "INF<D_HIGH" , "HavletListener received message"), - 
if {haveReplied == true) return i_replied; 

} 

return i_replied; 

} 

} 

class QuitButtonListener implements ActionListener 

{ 

// Constructor 

public QuitButtonListener () 

{ 
} 

// This method is performed when the QUIT button was pressed 

public void actionPerf ormed (ActionEvent e) 

{ 

uninstall ( ) ; 
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} 

class ButtonListener implements ActionListener 

{ 

Servicelnf ormation my_service_inf ormation; 
SEID my_dest_seid; 

// Constructor 

public ButtonListener (Servicelnf ormation service_inf ormation, SEID 

dest_seid) 

{ 

my_service_inf ormation = service_inf ormation; 
my_dest_seid = dest_seid; 

} 

// This method is performed when a button was pressed 

public void actionPerf ormed (ActionEvent e) 

{ 

try { 

Perf ormControl Command ( 0 , 
my_service_inf ormation. getControlUrl () , my_service_inf ormation . getServiceType {) , 
my__service_inf ormation. get ServiceTypeVers ion { ) , 

my_service_inf ormation. getActionName () , null, null, new Vector () , new Vector (}, 
my_dest_seid) ; 

} catch (Exception ex) { 

log ( "WARNING" , "HavletUpnpDevice : : ButtonListener : 
Perf ormControl Command ( ) failed l M ) ; 

} 

} 

} 

class ButtonListenerOut implements ActionListener 

{ 

Servicelnf ormation my_service_inf ormation ; 
SEID my_dest_seid; 
Label my_out_label ; 

// Constructor 

public ButtonListenerOut (Servicelnf ormation service_inf ormation, SEID 
de s t_s e i d , Labe 1 out__l abe 1 ) 

my_service_inf ormation = service_inf ormation ; 
my_dest_seid - dest^seid; 

my_out_label = out_label; 

} 

// This method is performed when a button was pressed 

public void actionPerf ormed (ActionEvent e) 

{ 

try { 

Vector return_variable_name = new Vector () ; 

Vector return_variable_value = new Vector 0; 

Perf ormControlCommand (0 , 
my_service_inf ormation . getControlUrl ( ) , my_service__inf ormation. getServiceType ( ) , 
my_service_inf ormation . getServiceTypeVersion ( ) , 

my_service_inf ormation. getActionName () , null, null, return_variable_name, 
return__variable_value, my_dest_seid) ; 

if (return_variable__name. size () > 0) { 

for (int i»0 ; i<return_variable_name . size ( ) ; i + +) { 
if 

( ( (String) re turn_variable_name. element At (i) ) .equals (my__service_inf ormation. get Ar 
gumentName ( ) ) == true) { 
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my_out_label . setText ( " 
"+ (String) return_variable_value .element At (i) ) ; 

} 

} 

} 

} catch (Exception ex) { 

log ( "WARNING" , "HavletUpnpDevice : : ButtonListenerOut : 
Perf ormControl Command () failed! ) ; 

} 

} 

} 

// Listener for the sliders 

class SliderListener implements Adjus tmentListener 

{ 

Servicelnf ormation my_service_inf ormat ion; 
SEID my_dest__seid; 

// Constructor 

public SliderListener (Servicelnf ormation service_inf ormation, SEID 

dest_seid) 

my_service_inf ormation = service__inf ormat ion ; 
my_dest_seid ■ dest_seid; 

} 

If This method is performed when the slider is moved 

public void adjustmentValueChanged (Adj ustmentEvent e) 

{ 

int min = Integer . par selnt (my_service_inf ormation . getMin ()) ; 
int max = Integer . parselnt (my_service_inf ormation . getMax () ) ; 
int step = Integer . parselnt (my_service__inf ormation . getstep ()) ; 
int var = (e . getValue ( ) -min) *step+min; 
try { 

Perf ormControl Command (0 , 
my_service_inf ormation. getControlUrl () , my_service_inf ormation . getServiceType (} , 
my_service_information.getServiceTypeVersion () , 
my_service_inf ormation. getActionName () , 

my_service_inf ormation. getArgumentName < ) , new String (" " +var) , new Vector () , new 
Vector () , my_dest_seid) ; 

} catch (Exception ex) { 

log ("WARNING", "HavletUpnpDevice: : ButtonListener : 
Perf ormControl Command ( ) failed I " ) / 

} 

} 

} 

void log (String type. String text) 

{ 

if (private_log_method_available == -1) { 

// Check if the private log method in Sof twareElement is available 
private_log_method_available = 0; 

Method[] methods = hv_se .getClass () .getMethods ( ) ; 
for (int i=0 ; i<methods . length; i++) { 

if (methods [i] . getName () .compareTo ( "log" ) == 0) { 

private_log_method_available = 1; 

private_log_method = methods [i] ; 

break; 

} 

} 

} 

if (private_log_jnethod_available ==1) { 
// The private method is available 
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Object [] paratn - new Object [33 ; 
int type_val; 

if ( type. equal slgnoreCase ("ERROR") == true) { 

type_yal = 0x01; 
} else if ( type. equals Ignore Case ("WARNING" ) == true) { 

type_val = 0x02; 
} else if ( type. equal s IgnoreCase ("INIT") == true) { 

type_yal = 0x04; 
} else if (type. equals Igno reCa se ( "INFO_LOW" ) == true) { 

type_val = 0x10; 
} else if (type . equal slgnoreCase ( "TIME " ) -» true) { 

type_val = 0^.2 0; 
} else { 

type_val = 0x0 8; 

param[0] = new Integer (type_val) ; 
param[l] = new Integer (0x00000020) ; 
param[2] = text; 
try { 

private_log_method. invoke (hv_se / param) ; 
} catch (Exception ex) { 

} 

} else { 

// The private method is not available 
System. out .println (tvpe+ "\t"+text) ; 

} 

} 

// 

// Class: HavletThread 

// The HavletThread builds the VI of the Havlet and creates all necessary 
AWT listeners 

// 

class HavletThread extends Thread 

{ 

// Constructor 

public HavletThread (String name) 

{ 

super (name ) ; 

} 

// The RUN method 

public void run() 

{ 

// Fetch the image for the Background 
byte [] b = HavletResource . getResource (getClass { ) , 
" com / 1 hmul t i /havi / upnp / upnp_l ogo . gi f " ) ; 

Image bimg; 
if (b null) { 
bimg = null; 
} else { 

bimg = Toolkit . getDef aultToolkit ( ) . createlmage (b) ; 

> 

// Create the Panel for the UI 

GridBagLayout ui_gridbag = new GridBagLayout () ; 

GridBagConstraint s u:_constraints = new GridBagConstraints ( ) ; 
Panel ui_jpanel = new Panel (ui_gridbag) ; 

// Set the constraints to the default value 
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int nrows = 0 / 
ui_constraints .gridx - 0; 
ui_constraints .gridy = nrows; 
ui_constraints .gridwidth = 1; 
ui_constraints .gridheight = 1; 
ui_constraints . weightx = 0; 
ui_constraints .weighty = 0; 

ui__constraints .insets = new Insets (2 , 2 , 2 , 2 ) ; 
ui_constraints .anchor - GridBagConstraints .NORTHWEST; 

try { 

// Fetch the name of the device 

StringHolder userj)referred_nanie = new StringHolder ( ) ; 
dcm_client .getUserPref erredNameSync (0 , user_pref erred_name) ; 

// Add the name to the UI 

Label lab = new Label (use r_jpref err ed_name . getValue ()) / 
lab.setFont (new Font ( "Helvetica" , Font . BOLD, 2 5) ) ; 
ui_gridbag. setConstraints (lab, ui__constraints) ; 
ui_panel . add (lab) ; 

// Build the UI for all services of all FCMs -- 
SEID[] f cm_seid_list = fcm_seids .getValue [) ; 
if (fcm_seid_list .length > 0) { 

IntHolder nservices = new IntHolder (0 ) ; 

for (int if cm = 0;ifcm < f cm_seid_list . length; if cm++) { 

// Loop over all FCMs 

fcm_seid = f cm_seid_list [if cm] ; 

// Fetch the device name of the FCK and add it to the UI 

StringHolder device__type = new StringHolder 0 ; 

GetDeviceType (0 , device_type, fcm_seid) ; 

lab = new Label (device_type . getValue ()) ; 

lab . setFont (new Font ( "Helvetica " , Fcnt . BOLD ,20)) ? 

nrov?s++; 

ui_constraints . gridy = nrows; 
ui_constraints . weightx = 0; 

ui_gridbag . setConstraints (lab, ui_constraints) j 
ui_panel . add ( lab ) ; 

// Fetch the number of service lists 
GetServiceDescriptions (0 , nservices, f cm_seid) ; 
if (nservices . getValue ( ) > 0) { 
for (int 

iservice=0 ; iservice<nservices . getValue ( ) ; iservice++) { 

// Loop over all available service lists 
// Fetch the service list 

Vector service_inf ormations = new Vector () ; 
GetServicelnf ormationList (0, iservice, 

service_inf ormations , fcm_seid) ; 

if (service__inf ormations . size ( ) > 0) { 
for (int 

j = 0; j <service_inf ormations . size ( } ; j ++) { 

// Loop over all service informations of 

the single service lists 

Service Information 

current_service_inf ormation - 

(Servicelnf ormation) service_inf ormations . elementAt (j) ; 

if 

(current_service_inf ormation. get Has Arguments ( } == false) { 

// -- It's a simple action. So we 

can create a button for this action. -- 
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Button button = new 
Button(current_service_information.getActionName () ) ; 

ButtonListener bl = new 
ButtonListener (current_service_inf ormation, fcm_seid) ; 

button . addActionListener (bl ) / 

nrowsf+; 

ui_constraints . gridy = nrows ; 
ui_constraints . f ill - 

GridBagConstraints .NONE; 

ui_constraints . weightx - 0; 
ui_gridbag. setConstraints (button, 

ui_constraints) ; 

ui_panel . add (button) ; 
} else { 

// The action has some arguments. 

Fetch the direction. 

if 

(current_service_inf ormation . getDirection (). equals ( "in" ) == true) { 

// -- It is a variable sent to 

the device - - 

if 

(current_service_inf ormation. getHasValueRange O == true) { 

//We can select values in a 

range . 

if 

(current_service_inf ormation. getDataType () . equals ( "uil" ) | 

current_service_inf ormation. getDataType {) .equals ("ui2 11 ) 

current_service_inf ormation. getDataType () .equals ("ui4" ) 

current_service_inf ormation. getDataType () .equals ( "il" ) | 

current_service_inf ormation. getDataType () . equals { "i2 " } | 

current_service_inf ormation. getDataType 0 . equals ( "i4 " ) | 

current_service_inf ormation. getDataType () .equals ( "int ") ) { 

// Create the Panel for 

the slider and the label 

GridBagLayout 
GridBagConstraints 
Panel 

slider_constraints .gridx 
slider__constraints .gridy 



slider_gridbag = new GridBagLayout (> ; 

slider_constraints = new GridBagConstraints () ; 
slider_panel = new Panel {si ider__gridbag) ; 

= 0; 
- 0; 



si ider_constraints . gridwidth = 1; 
slider_constraints . gridheight = 1; 
slider_constraints . weightx = 0; 
slider_constraints . weighty = 0; 

slider_constraints . anchor = GridBagConstraints .WEST ; 
add it to the panel 

Label ( cur rent_service_inf ormation. getActionName () ) ; 



// Create the label and 



Label slider label = new 
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slider_gridbag.setConstraints (slider_label , slider_constraints) ; 



slider_panel . add (slider_ label) ; 
information of the slider 
step = 1, visible; 

current_service_inf ormation . getMin ( ) ; 
min = Integer .parselnt (val) ; 
current_service_inf ormation . getMax ( ) ; 
max = Integer .parselnt (val) ; 
current_service_inf ormation . getStep ( ) ; 
step = Integer .parselnt (val) ; 



/ / Fetch the range 

int min = 0, max = 100 , 

String val = 

if (val. length;) > 0) 



val = 



if (val . length [ ) > 0) 



val = 



if (val .length [) > 0) 



current_service_inf ormation. setMinMax (new String ("" -nmin) , new String {" "+max) , 
new String (" "+step) ) ; 

visible = (max-min+1) / 

10; 

if (visible <= 0) 

visible=l; 

/ / Fetch the current 

value of the variable represented by the slider 

StringBuf f er 

current_variable__value = new StringBuf fer () ; 

PerformDeviceVariableQuery (0 , current_service_inf ormation . getControlUrl () , 
current_service_inf ormation. getRelatedStateVari able () , current__variable_yalue r 
f cm_seid) ; 

int current_value = 1; 
if 

(current_variable__value . length () > 0) current_value = 
Integer .parselnt (current_variable_value. toStringO ) ; 

// Create the scrollbar 

and add it to the panel 

Scrollbar sb = new 
Scrollbar (Scrollbar. HORIZONTAL, 0, visible, min, (max-min) /step+min) ; 



sb . setValue ( (current__value-min) / step+min) ; 



® 



sb . addAdjustmentListener (new SliderListener ( cur rent_s ervi ce_inf ormation, 
f cm_seid) ) ; 

slider_constraints . gridx 

= i; 

slider__constraints . fill 

= GridBagConstraints . HORIZONTAL; 



slider_constraints . weightx = 100; 

slider_gridbag. setConstraints (sb, si ider_constraints) ; 



to the UI 



nrows ; 



GridBagConstraints . HORIZONTAL; 



slider_panel .add (sb) ; 
// Add the slider panel 

nrows ++ ; 

ui_constraints .gridy = 
ui constraints . fill = 



47 



EP 1 355 485 A1 



ui__c constraints . weightx = 

100 ; 

ui_gridbag.setConstraints (sliderjpanel , ui_constraints) / 
ui_panel . add (slider_panel) ; 

} else { 

// We can select values 

in a range. But they are not integer! 

log ("ERROR", 

"HavletUpnpDevice : : HavletThread : Range non Integer"); 

} else if 

( currents ervi ce_i nf ormation . getHasValueLi st ( ) == true) { 

// There is a value list 

available 

log ("WARNING" , 

"HavletUpnpDevice HavletThread: Value list available"}; 

} else { 



or value list defined 
value entry 

entry_gridbag = new GridBagLayout () ; 

entry_constraints = new GridBagConstraints () ; 
entry_panel = new Panel (entry_gridbag) ; 



// There is no value range 

// Create the Panel for 

GridBagLayout 

GridBagConstraints 

Panel 

entryconstraints . gridx = 0; 
entry_constraints .gridy = 0; 
entry_constraints .gridwidth 



entry constraints .gridheight 
entry_constraints .weightx » 
entry_constraints . weighty = 
entry_constraints . anchor = 
// Create the label and add 
Label entry_label = new 



= l; 
= 1; 
0; 
0; 

GridBagConstraints . WEST; 
it to the panel 
Label (current_service_in format ion. get Ac tionName () ) ; 
entry_gridbag . setConstraints (entry__label , entry_constraints) ; 
entry_j?anel . add (entry_label) ; 

// Fetch the current value 

of the variable represented by the entry 

StringBuf f er 

current_variable__value = new Str ingBuf f er ( ) ; 

Perf ormDeviceVariableQuery ( 0 , current_service_inf ormation . getControlUrl ( ) , 
current_service__inf ormation. getRelatedStateVariable () , current_variable_value, 
fcm__seid) ; 

// Create the entry and add 

it to the panel 

TextField tf = new 

TextField (current_variable_value . toString ( ) ) ; 

//sb . addAdjustmentListener (new SliderListener (current_service_inf ormation, 
f cm_seid) ) ; 
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GridBagConstraints .HORIZONTAL; 



100; 



entry_constraints . gridx = 1; 
entry_constraints . f ill = 

entry_constraints . weightx = 



entry_gridbag. setConstraints (tf , entry_cons traints) ; 



the UI 
nrows ; 

GridBagCons traints . HORIZONTAL; 
100; 



entry__panel . add (tf ) ; 

// Add the entry panel to 

nrows ++ ; 

ui_constraints .gridy = 
ui__cons traints . f ill = 
ui_cons traints . weightx = 



ui_gridbag. setConstraints (entry_j?anel , ui_constraints) ; 

ui__panel . add (entry_panel) ; 

} 

} else if 

{current_service_information.getDirection() . equals ( "out " ) == true) { 

// -- It is a variable received 

from the device -- 

GridBagLayout out_gridbag 
GridBagCons traints 
Panel out_panel 



= new GridBagLayout () ; 

out_constraints ■ new GridBagConstraints 0 ; 
= new Panel (out_gridbag) ; 



out_constraints .gridx = 0; 
out_constraints .gridy = 0; 
out__constraints . gridwidth = 1; 
out_constraints . gridheight = 1; 
out__constraints . weightx = 0; 
out_cons traints .weighty = 0; 
out_constraints . anchor = 

GridBagConstraints. WEST; 

// Create the Label for the 

value returned 

Label out_label = new Label ( " 

(unknown value) ") ; 

// Create the button and add it 

to the panel 

Button out_button = new 
Button (current_service_inf ormation . get Ac tionName 0 ) ; 

out_button. addActionLi stener (new 

ButtonListenerOut ( current_service_inf ormation, fcm_seid, out_label) ) ; 

out_gridbag. setConstraints (out_button, out_constraints) ; 

out_panel . add (out_button) ; 
// Add the Label to the Panel 
out_constraints . gridx = 1; 
out_constraints . f ill = 

GridBagConstraints .HORIZONTAL; 

out_constraints . weightx = 10 0; 

out_gridbag. setConstraints (out_label, out_cons traints) ; 

out_panel . add (out_label) ; 

// Fetch the current value of 

the variable represented by the out 

//StringBuf f er 

current_variable_value = new StringBuf fer {) ; 
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/ /Perf ormDeviceVariableQuery { 0 , 

current_service__information.getControlUrl () , 

current_service_information.getRelatedStateVariable () , current_variable_yalue , 
fcm__ seid) ; 

// Create the out and add it to 

the panel 

// Add the out panel to the UI 
nrows++; 

ui_constraints . gridy = nrows ; 
ui_constraints . f ill = 

GridBagConstraints .HORIZONTAL; 

ui_constraints . weightx = 100; 

ui_gridbag . setConstraints (out_panel , ui_constraints) ; 

ui_panel . add (out_j?anel) ; 
//log ( "ERROR" , 

"HavletUpnpDevice : :HavletThread : out variable"); 

} else { 

log ("WARNING", 

"HavletUpnpDevice : :HavletThread: Found unknown 
direction: " +current service information. getDirection ()) ; 

} 

} 

} 

} 

} 

} 

} 

} 

} catch (Exception e) { 
e . printStackTrace () ; 

log ( "WARNING" , "HavletUpnpDevice HavletThread : Exception 
occured when fetching UPnP device description"); 

return; 

} 



// Create the window 

win = new BackgroundMosaicWindow (new Frame () , biimg) ; 
win, setLayout (null) ; 

window_height = win .getToolkit () .getScreenSize () . height ; 
window_width = win .getToolkit () .getScreenSize (). width; 
win . setBounds ( 0 , 0, window__width, window_height) ; 

// Build the panel for the center 
GridBagLayout gridbag = new GridBagLayout ( ) ; 
GridBagConstraints constraints = new GridBagConstraints () ; 
TPanel main_panel = new TPanel (gridbag) ; 

// ScrollPane 

ScrollPane sp = new ScrollPane ( ScrollPane . SCROLLBARS_AS_NEEDED) ; 

//sp_jpanel = new Panel (); 

//sp_panel . setLayout (new FlowLayout {) ) ; 

//Button testl = new Button ( "testl 11 ) ; 

//sp_panel . add (test 1) ; 

sp. add (ui_panel) ; 

sp. setsize (400, (window_height*8) /10) ; 

constraints . gricbc = 0; 
constraints . gridy = 0; 
constraints . gridwidth = 1; 
constraints .gridlieight = 1; 
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constraints .weightx - 0? 
constraints ..weighty = 0 ,* 

constraints .anchor = GridBagConstraints .NORTH ; 
gridbag.setConstraints(sp, constraints) ; 
main__panel . add (sp) ; 

// QUIT button 

Button quit « new Button ( "QUIT" ) ; 

quit .addActionListener {new QuitButtonListener ( ) ) ; 
constraints . gridx = 1; 

gridbag. setConstraints {quit, constraints) ; 
main_panel . add (quit ) ; 

// Make the window visible 
main_panel . setBounds { (window_width- 
main_panel .getPref erredSize () .width) /2, (window_height- 

mainjjanel . getPref erredSize () .height) /2 , niain_panel .getPref erredSize () . width, main 
_panel .getPref erredSize () .height) ; 

win. add (main_j?anel) ; 

win. pack ( ) ; 

win. setVisible (true) ; 

win. repaint () ; 

win. toFront () ; 

win. repaint () ; 

} 

} 



// Methods for accessing the the special UPnP API of the FcmUpnp 



Ij GetServiceDescriptions 

public final void GetServiceDescriptions {int timeout, IntHolder nservices, 

SEID dest_seid) 

throws HaviGeneralException, HaviMsgException 

{ 

HaviByteArrayOutputStream msg = new HaviByteArrayOutputStream ( ) ; 

HaviByteArraylnputStream msg_back = new Havi Byte Array Input St ream ( ) / 
OperationCode op__code=null; 

StatusHolder return_code = new StatusHolder () ; 
try { 

op_code = new OperationCode (ConstApiCode . FCM # 
ConstFcmUpnpOperationId.GET_SERVICE_DESCRIPTIONS) ; /P\ 
} catch (HavilnvalidValue Except ion e) { Vfa/ 
throw new HaviUnidentif iedFailureExcept ion (Cons tApi Code . FCM) ; 

} 

hv_se.msgSendRequestSync (dest_seid, opcode, timeout, msg, msg_back, 
return_code) ; 

// Check the return_code 

HaviException return_exception = return_code .getValue ( ) . makeException () ; 
if ( return__excep t ion != null) { 

if ( (returnjsxception instanceof HaviGeneralException) == true) { 

throw (HaviGeneralException) return_exception; 
} else if ( (return_exception instanceof HaviMsgException) == true) { 

throw (HaviMsgException) return_exception; 
} else if ( <return_exception instanceof HaviFcmException) == true) { 
switch (return_code . getValue { ) . getErrorCode ( ) } { 
default : 
throw new 

HaviUnidentif iedFailureExcept ion (ConstApiCode . FCM) ; 

} 
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} else { 

throw new HaviUnidentif iedFailureException ( Con stApi Code. FCM) ; 

} 

} 

// Build the data to be returned 
try { 

nservices .unmarshal (msg_back) ; 
} catch (HaviUnmarshallingException e) { 

throw new HaviUnidentif iedFailureException (ConstApiCode . FCM) ; 

} 

} 

// GetDeviceType 

public final void GetDeviceType ( int timeout, StringHolder device__type , SEID 
dest_seid) 

throws HaviGeneralException, HaviMsgException 

HaviByteArrayOutputStream msg = new HaviByteArrayOutputStream () ; 

HaviByteArraylnputStream msg_back = new HaviByteArraylnputstream () ; 
OperationCode op_code=null ; 

StatusHolder return_code = new StatusHolder () ; 
try { 

op_code = new OperationCode (ConstApiCode . FCM, 
Cons tFcmUpnpOp era tionld , GET__DEVICE__TYPE) ; 

} catch (HavilnvalidValueException e) { 

throw new HaviUnidentif iedFailureException (ConstApiCode - FCM) ; 

} 

hv_se .msgSendRequestSync (dest_seid, op_code, timeout, msg, msg_back, 
return_code) ; 

// Check the return_code 

HaviException return_exception = return_code . getvalue 0 .makeException ( ) 
if (return_exception != null) { 

if { (return_exception instanceof HaviGeneralException) ■« true) { 

throw (HaviGeneralException) return_exception; 
} else if ( (return_exception instanceof HaviMsgException) == true) 

throw (HaviMsgException) return_except ion ; 
} else if ( (return_exception instanceof HaviFcmException) == true) 
switch (return_code. getvalue () . getErrorCode () ) { 
default : 
throw new 

HaviUnidentif iedFailureException (ConstApiCode . FCM) ; 

} 

} else { 

throw new HaviUnidentif iedFailureException (ConstApiCode . FCM) ; 

} 

} 

// Build the data to be returned 
try { 

device_type . unmarshal (msg_back) ; 
} catch (HaviUnmarshallingExcept ion e) { 

throw new HaviUnidentif iedFailureException (ConstApiCode . FCM) ; 

} 

} 

// GetServicelnformation 

public final void GetServicelnf ormationList (int timeout, int iservice, 
Vector service_inf ormations, SEID dest_seid) 

throws HaviGeneralExceotion, HaviMsgException 

{ 
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HaviByteArrayOutputStream msg = new HaviByteArrayOutputStream ( ) ; 

HaviByteArraylnputStream msg_back = new HaviByteArray Input Stream () ; 
OperationCode op_code=null ; 

StatusHolder return_code = new StatusHolder () ; 

try { 

op_code = new OperationCode (ConstApiCode . FCM, 
Const FcmUpnpOper at ionld. GET_SERVICE_INFORMATION_LIST) / 
} catch (HavilnvalidValueException e) { 

throw new HaviUnidentif iedFailureException (ConstApiCode . FCM) ; 

} 

msg. writelnt (iservice) ; 

hv_se .msgSendRequestSync (dest_seid, op_code, timeout, msg, msg__back r 
return_code) ; 

// Check the return_code 

HaviException return_exception = return_code . getValue ( ) .makeException () ; 
if (return_exception !- null) { 

if ( (return_exception instanceof HaviGeneralException) == true) { 

throw (HaviGeneralException) re turn_except ion; 
} else if ( (return_exception instanceof HaviMsgException) == true) { 

throw (HaviMsgException) re turn_exception; 
} else if ( (retum_exception instanceof HaviFcmException) == true) { 
switch (return_code. getValue 0 . getErrorCode () ) { 
default : 
throw new 

HaviUnidentif iedFailureException (ConstApiCode . FCM) ; Vjjflf 

} 

} e 1 se { 

throw new HaviUnidentif iedFailureException (ConstApiCode . FCM) ; 

} 

} 

// Build the data to be returned 
try { 

int nservices = msg_back. readlnt ( ) ; 
if (nservices > 0) { 

for (int i=0 ; i<nservices; i++) { 

servicej nformations . add (new Servicelnf ormation (msg_back) ) ; 

} 

} 

} catch (Exception e) { 

throw new HaviUnidentif iedFailureException (ConstApiCode . FCM) ; 

} 

} 

// Perf ormControl Command 

public final void Perf ormControlCommand (int timeout, String control_url, 
String service_type, String service_type_v, String action, String variable_name , 
String variable_value, Vector return_variable_name , Vector 
return_variable_ value, SEID dest_seid) 

throws HaviGeneralException, HaviMsgException 

{ 

HaviByteArrayOutputStream msg = new HaviByteArrayOutputStream () ; 

HaviByte Array Input St ream msg_back = new HaviByteArray InputStream () ; 
OperationCode op_code-null ; 

StatusHolder return_code = new StatusHolder () ; 
try { 

op_code = new OperationCode (ConstApiCode . FCM, 
Cons t FcmUpnpOper at ionld. PERFORM_C0NTROL_COMMAND ) ; 

} catch (HavilnvalidValueException e) { 

throw new HaviUnidentif iedFailureException (ConstApiCode . FCM) ; 
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} 

msg . writeHaviString (control^url ) ; 
msg . writeHa viS t ring (service_type) ; 
msg . writeHaviString (service_type_v) 
msg . writeHaviString (action) ; 

if (variable_name == null | | variable__value == null) { 

msg . write int (0) ; 
} else { 

msg . writelr.t (1) ; 

msg . writeHaviString (variable_name) ; 
msg . writeHaviString (variable_value) ; 

} 

hv_se.msgSendRequestSync (dest_seid, op_code, timeout, msg r msgback, 
return_code) ; 

// Check the return_code 

HaviException return_exception = re turn__code . getValue (} .makeExcept ion () ; 
if (retum_exception != null) { 

if ( (return_exception instanceof Havi Gene ralExcept ion) == true) { 

throw (Havi Gene ralExcept ion) return^exception; 
} else if ( (return_exception instanceof HaviMsgException) == true) { 

throw (HaviMsgException) return_exception; 
} else if ( (return_exception instanceof HaviFcmException) == true) { 
switch ( return__code. getValue <) .getErrorCode () ) { 
default : 
throw new 

HaviUnidentif iedFailureException (ConstApiCode . FCM) ; 

} else { 

throw new HaviUnidentif iedFailureException (ConstApiCode . FCM) ; 

} 

} 

// Build the data to be returned 
try { 

int nvar = msg_back . readlnt () ; 
if (nvar > 0) { 

for (int i=0;i<nvar; i-f-+) { 

return_variable_name .addElement (msg_back. readHaviString () ) ; 

return_variable_value . addElement (msg_back . readHaviString () ) ; 

} 

} 

} catch (Exception e) { 

throw new HaviUnidentif iedFailureException (ConstApiCode . FCM) ; 

} 

} 



// Perf ormDevice Variable Query 

public final void Perf ormDeviceVariableQuery (int timeout, String 
control_url y String variable_name, StringBuffer return_value , SEID dest_seid) 
throws HaviGeneralException, HaviMsgException 

{ 

HaviByteArrayOutputStream msg = new HaviByteArrayOutputStream ( ) ; 

HaviByteArraylnputStream msg_back = new HaviBy teAr ray Input St ream () ; 
OperationCode op_code=null ; 

StatusHolder return_code = new StatusHolder (} ; 
try { 

op_code = new OperationCode (ConstApiCode . FCM, 
ConstFcmUpnpOperationld. PERFORM_DEVICE_VARIABLE_QUERY) ; 
} catch (Havi invalidValueExcept ion e) { 

throw new HaviUnidentif iedFailureException (ConstApiCode . FCM) ; 

} 
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meg .writ eHaviSt ring (control__url) ; 
msg . writeHavistring (variable_name) ; 



hv_se.msgSendRequestSync (dest__sei d, op_code, timeout, msg, msg_Jback, 
return code) ; — 

® 

// Check the return_code 

HaviException return_exception = return_code .getValue { ) .makeException () ; 
if (return_exception 1= null) { 

if ( (return_exception instanceof HaviGeneralException) -= true) { 

throw (HaviGeneralException) return_exception ; 
} else if ( (return_exception instanceof HaviMsgException) true) { 

throw (HaviMsgException) return_except ion ; 
} else if ( (return_exception instanceof HaviFcmException) == true) { 
switch (return_code. getValue () . getErrorCode () ) { 
default : 
throw new 

HaviUnidentif iedFailureExcept ion (ConstApiCode . FCM) ; 

} 

} else { 

throw new HaviUnidenti f iedFailureExcept ion (ConstApiCode . FCM) ; 

} 

} 

// Build the data to be returned 
try { 

ret urn_value. append (msg_back. readHaviString ( ) ) ; 
} catch (Exception e) { 

throw new HaviUnidentif iedFailureExcept ion (ConstApiCode . FCM) ; 

} 

} 



} 

Fig- 5 
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// 

// Copyright (c) 2000-2 001, This software is the property of Thomson 
// multimedia, and shall not be reproduced, copied, or distributed 
// without written permission. 



// 

// TITLE: 

class . 

// AUTHOR (a) : 
// DATE CREATED 
FILENAME: 
PROJECT : 
COPYRIGHT: 



ServiceDescription - Implementation of the ServiceDescription 



// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 



Ingo Hutter 
24.09.2001 

ServiceDescription . j ava 
DHN (HAVi implementation) 
(C) 2000-2001 THOMSON multimedia, 
THIS SOFTWARE IS THE PROPERTY OF THOMSON multimedia, AND SHALL NOT 
BE REPRODUCED , COPIED, OR DISTRIBUTED WITHOUT WRITTEN PERMISSION . 



VERSION: 1.1 

MODIFICATION HISTORY: 
DATE MODIFIED: 
AUTHOR ( s 3 : 
MODIFICATION MADE : 
PROBLEM CAUSING MODIFICATION: 

DESCRIPTION: 

ServiceDescription contains all information about a UPnP service 



package com. thmulti . havi .upnp; 

import org . havi . system . Sof twareElement ; 

import org. havi . types .HaviUnidentif iedFailureException; 

import org . j dom . * ; 

import org . j dom . input . * ; 

import org . j dom . output . * ; 

import : ava . ut i 1 . * ; 

import java.io.*; 

import : ava . net . * ; 

public class ServiceDescription 

{ 

String my_service_type 

String my_service_version 

String my_service_id 

String my_scpd_url 

String my_control_url 

String my_event_sub_url 

String my_delivery_url 

String subscript ion__uuid 
where the eventing is subscribed 

String subscription_timeout 

Date subscription_expire_date 

Element xml_action_list 

Element xml_service_state_table 

Namespace nss; 

public ServiceDescription () 

{ 
} 



null 
null 
null 
null 
null 
null 
null 
null 

null 
null 
null 
null 



// UUID returned from the Device 



public boolean init (Element xml service, Namespace ns, String base_url) 
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// Fetch ServiceType 

Element xml_service_type = xml_service . geuChild ( " serviceType" , ns ) ? 
if (xml_service_type == null) return false; 

StringTokenizer st = new StringTokenizer (xml_service_type . getText ( ) , ":"); 
try { 

if (st.nextTokenO .equals {"urn") =- true) { 

if {st.nextTokenO . equals (" schema s-upnp -org") == true) { 
if (st.nextTokenO . equals ( "service" ) == true) { 
my_service_type = st.nextTokenO; 
my_service_version = st.nextTokenO; 

} 

} 

} 

} catch (NoSuchElementException ex) { 
return false; 

} 

if (my_service__type == null my_service_version == null) return false; 
if (my_service_type . length 0 == 0 | | my_service_ver s ion. length 0 == 0) 
return false; 

// Fetch Serviceld 

Element xml_service_id = xml_service . getChild < " serviceld" , ns ) ; 
if (xml_service_id == null) return false; 

st = new StringTokenizer (xml_service_id. getText 0 , *':"); 
try { 

if {st .nextTokenO . equals ("urn" ) == true) { 
st.nextTokenO; 

if (st.nextTokenO . equals ("serviceld" ) == true) { 
my_service_id = st.nextTokenO; 

} 

} 

} catch (NoSuchElementException ex) { 
return false; 

} 

if (my_service_id == null) return false; 

if (my_service_id. length 0 == 0) return false; 

// Fetch SCPDURL 

Element xml_scpd_url = xml_service . getChild ( "SCPDURL" ,ns) ; 
if (xml_scpd_url == null) return false; 
my_scpd_url = base_url + xml_scpd_url . getText () ; 
if (my_scpd_url . length {) == 0) return false; 

// Fetch controlURL 

Element xml_control__url = xml^service , getChild ( " uonLiulURL" , ns ) ; 
if (xml__control_url == null) return false; 
my_control_url = base_url + xml_control_url . getText () ; 
if (my_control_url . length () == 0) return false; 

// Fetch eventSubURL 

Element xml_event__sub_url = xml_service . getChild ( "eventSubURL" , ns) ; 

if (xml_event_sub_url null) return false; 

my_eve n t_s ub_ur 1 = base_url + xml_event_sub_url . getText () ; 

if (my_event_sub_url . length {) == 0) return false; 

// Fetch the ServiceDescription 
try { 

SAXBuilder builder = new SAXBuilderO; 

Document doc = builder .build (new URL (my_scpd_url) ) ; 

if (doc == null) return false; 
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//XMLOutputter fmt = new XMLOutputter () ; 
//fmt .output (doc , System. out ) ; 

Element xml_xmls = doc . getRootElement ( ) ; 
if (xml_xmls == null) return false; 
nss = xml_xmls .getName space () ; 

xml_action_list = xml_xmls . getChild( "actionliist " , nss) ; 

xml_service_state_table = xml_xmls . getChild( " serviceStateTable" , nss) ; 
} catch (Exception ex) { 
return false; 

} 

return true; 



public String getServiceType () 
return my_service_type ; 

public String getServiceVersion( ) 
return ray_service_version; 



public String getServiceld ( ) 
return my_service_id; 



public String getScpdUrl () 
return my_scpd_url ; 



public String getControlUrl ( ) 
return my control url; 



public String get Even t S ubUrl () 
return my_event_sub_url ; 



public Vector get Act ions () 

Vector actions = new Vector (); 

List action_list = xml_action_list . getChildren < " action" , nss) ; 
for (int i=0 ; i<action_list . size () ; i++) { 

Element name - ( (Element) action_list .get (i) ) .getChild ( "name" , nss) ; 

if (name != null) actions . addElement (name .getText 0) ; 

} 

return actions; 

} 



public boolean c he ckActionName (String action) 

{ 

List action_list = xml_action_list . getChildren { 11 action" , nss ) ; 
for (int i=0 ; i<action_list . size () ; i++) { 

Element name = ( (Element) action_list .get (i) ) .getChild ( "name" , nss) ; 

if (name == null) break; 
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if (name. getText () .equals (action) == true) { 
return true; 

} 

} 

return false; 

} 

public String getActionArgumentDJame (String action) 

' List action_list - xml_acti on_list . getChildren ( "action" , nss ) ; 
for (int i=0; i<action_list . size () ;i++) { 

Element name = ( (Element) action_list .get (i) ). getChild ( "name" , nss) ; 
if (name == null) break; 

if (name .getText () . equals (action) == true) { 
// Fetch argumentList 
Element argument_list = 
( (Element) action_list . get (i) ) .getChild ("argumentList" , nss) ; 

if (argument_list != null) { 

List arguments = argument_list .getChildren ( "argument ", nss) ; 
if (arguments . size ( ) > 0) { 

Element f irst_argument = (Element ) arguments . get ( 0 ) ? 
Element xml_name = f i r s t__argument . getChild ( "name ", nss) ; 
return xml_name . getText ( ) ; 

} 

} 

} 

} 

return null; 

} 

public String getActionArguraentVariable (String action) 
{ 

List action_list = xml_act ion_list . getChildren ( "action" , nss) ; 
for (int i=0 ; i<action_list . size () ;i++) { 

Element name = ( (Element) action_list .get (i) ). getChild ( "name" , nss) 

if {name == null) break; 

if {name .getText 0 . equals (action) == true) { 
// Fetch argumentList 
Element argument_list = 
( (Element) action_list .get {!) ) . getChild ( "argumentList " , nss ) ; 

if (argument_list := null) { 

List arguments = argument_list .getChildren ("argument" , nss) ; 
if (arguments . size ( ) > 0) { 

Element f irst_argument - (Element ) argument s . get ( 0 ) ; 
Element xml_variable = 
first_argument .getChild { "relatedStateVariable " ,nss) ; 

return xml_var ± able .getText 0 ; 

> 

} 

} 

} 

return null; 

} 

public String getActionArgumentDirect ion (String action) 

{ 

List action_list = xml_action_list .getChildren ( "action" , nss) ; 
for (int i=0 ; i <action_lis t . size () ; i++) { 

Element name = { (Element) action_list .get (i) ) .getChild ( "name" , nss) ; 

if (name == null) break; 

if (name .getText () . equals (action) == true) { 
// Fetch argumentList 
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Element argument_list = 
( (Element) action_list. get (i) ) . getChild ( "argumentList " ,nss) ; 

if (argument_list != null) { 

List arguments = argument__list .getChildren ( "argument " , nss) ; 

if (arguments . size () > 0) { 

Element f irst_argument = (Element) arguments . get (0 ) ; 
Element xml_direction = 
fir st_argument .getChild ( "direction" ,nss) ; 

return xmldir ection. getText () ; 

} 

} 

} 

} 

return null; 

} 

public String getVariableDatatype (String variable) 
{ 

List variable_list = 
xml_service_state_table. getChildren ( "stateVariable nss) ; 
for (int i=0 ; i<variable_list .size () ;i++) { 

Element name = ( (Element) variable_list .get (i) ) .getChild ("name" , nss) ; 
if (name == null) break; 

if (name. ge tText () .equals (variable) == true) { 
/ / Fetch dataType 
Element data_type = 
( (Element) variable_list . get (i) ) . getChild ( "dataType nss ) ; 

if (data_type 1= null) { 

return data_type .getText () / 

} 

} 

} 

return null? 

} 

public String getVariableDef aultValue (String variable) 

{ 

List variable_list = 
xml_service_state_table . getChildren ( 11 stateVariable " , nss) ; 
for (int i=0 ; i<variable_list . size () ; i++) { 

Element name = ( (Element) variable_list .get (i) ) .getChild ( "name", nss) ; 
if (name == null) break; 

if (name .getText () .eguals (variable) == true) { 
// Fetch def aultValue 
Element def ault_value - 
( (Element) variable_list .get (i) ) .getChild ( "def aultValue" ,nss) ; 

if (def ault_value != null) { 

return def ault__value . getText () ; 

} 

} 

} 

return null ; 

} 

public String getVariableMinimum (String variable) 

{ 

List variable_list = 
xml_service_state_table .getChildren ( "stateVariable" , nss) ; 
for (int i=0 ; i<variable_list . size ( ) ; i++) { 

Element name = ( (Element ) variable_list . get (i) ). getChild ( "name " , nss ) ; 

if (name == null) break; 

if (name. getText () .equals (variable) == true) { 
// Fetch allowedValueRange 
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Element allowed_range = 
< (Element) variable_list. get (i) ) . getChild ( "allowedValueRange" , nss) ; 

if (allowed_range != null} { 

Element minimum = allowed_range . getChild ( "minimum" , nss ) ; 
if (minimum != null) { 

return minimum. getText 0 ; 

} 

} 

} 

} 

return null; 

} 

public String getVariableMaximum (String variable) 
{ 

List variable_list = 
xml_service_state_table.getChildren("stateVariable M ,nss) ; 

for (int i=0 ; i<variable_list . size () ; i++) { 

Element name - { (Element ) variable_list . get { i) ). getChild ( "name" , nss ) / 

if (name == null) break; 

if (name. getText () . equals (variable) == true) { 
// Fetch allowedValueRange 
Element allowed_range - 
( (Element )variable_list. get (i) ) .getChild ( "allowedValueRange" , nss) ; 

if (allowed_range != null) { 

Element maximum = allowed_range .getChild ("maximum" , nss) ; 
if (maximum != null) { 

return maximum . getText ( ) ; 

} 

} 

} 

} 

return null; 

} 

public String getVariableStep (String variable) 

{ 

List variable_list = 
xml_eervice_state_table.getChildren ("stateVariable" , nss) ; 
for (int i=0 ; i<variable_list . size () ; i++) { 

Element name = ( (Element) variable_list .get (i) ) .getChild ( "name" , nss) ; 
if (name == null) break; 

if (name .getText () . equals (variable) == true) { 
// Fetch allowedValueRange 
Element allowed_range - 
( (Element) variable_list. get (i) ) .getChild ( "allowedValueRange" ,nss) ; 

if (allowed__range l= null) { 

Element step = allowed_range .getChild ( "step" , nss) ; 
if (step != null) { 

return step .getText () ; 

> 

} 

} 

} 

return null; 

} 

public Vector getVariableListValues (String variable) 

{ 

Vector found_values = new Vector () ; 
List variable_list *= 
xml_service__state_table.getChildren ( "stateVariable" , nss) ; 
for (int i=0 ; i<variable_list . size () ;i++) { 
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Element name = ( (Element) variable_list . get ( i) ). getChild ( "name" , nss } ; 
if (name == null) break; 

if (name. getText () . equals (variable) == true) { 
// Fetch allowedValue Range 
Element allowed_value_list = 
( (Element )variable_list. get (i) ) .getChild ( "allowedValueList" , nss) ; 

if <allowed_value_list != null) { 

List a Howe devalues = allowed^ value_list - getChildren () ; 
for (int j =0 ; j <allowed_values . size ( ) ; j ++) { 

f ound_values . addElement ( ( (Element) allowed_values .get (i) ) .getText () ) ; 

} 

return f ound__values ; 

} 

} 

} 

return null; 

} 

public Servicelnformation [] getServicelnf ormationList ( ) 

{ 

Vector actions = getActions {) ; 

Servicelnformation [] service^ inf ormations = new 
Servicelnformation [actions . size ( ) ] ; 

if (actions. size () > 0) { 

for (int i=0 ; i<actions . size () ; i++) { 
service_inf ormations [i] = 
getServicelnf ormation ( (String) actions . elementAt (i) ) ; 

} 

} 

return service informations; 




public Servicelnformation getServicelnf ormation (String action) 

{ 

Servicelnformation service_inf ormation = new 
Servicelnformation (my_control_url , my_service_type , my_service_version, 
my_service_id, action) ; 

if ( get Act ionArgumentName (action) != null) { 

service_inf ormation. setArguments (getAct ionArgumentName (action) , 
getActionArgumentDirection (action) , getActionArgument Variable (action) , 
getVariableDatatype (getActionArgumentVariable (action) ) ) ; 

if (getVariableMinimum (getActionArgumentVariable (action) ) != null) { 
String step = getVariableStep (getActionArgumentVariable (action) ) ; 
if (step == null) step = new String ( "1" ) ,- 

service_inf ormation. setMinMax (getVariableMinimum (getActionArgumentVariable (action) 
) , getVariableMaximum( getActionArgumentVariable (action) ) , step) ; 

} 

if (getVariableListValues (getActionArgumentVariable (action) ) != null) 

{ 

service_inf ormation. setAllowedValues (getVariableListValues ( getAct ionArgumentVariab 
le (action) ) ) ; 

} 

} 

return service_inf ormation; 

} 

// 

// sendEventSubscription 

//An Event Subscription message is sent to the related UPnP service 



62 



EP 1 355 485 A1 



// 

public boolean sendEventSubscript ion (String deliveryurl, int timeout) 

{ 

if (my_delivery_url =- null) { 

my_delivery_url = deliveryUrl; 
} else { 

if (my_delivery_url . equals (deliveryUrl) == false) { 

SoftwareElement. log (SoftwareElement .MSG_WARNING, "ServiceDescription . sendEventSubsc 
ription(): The delivery URL changed from "+my_delivery_url+" to "+deliveryUrl+ " . 
Not allowed ! 11 ) ; 

return false; 

} 

} 

return sendEventSubscript ion (timeout ) ; 

} 

public boolean sendEventSubscription (int timeout) 
{ 

// Check if an Event SUB URL is defined 
if (my_event_sub_url == null) { 

Sof twareElement. log (SoftwareElement . MSG_WARNING, "ServiceDescription . sendEventSubsc 
ription(): No event sub URL defined. Give up!"); 

return false; 

} 

boolean ret_value = true; 
try { 

// Build the URL 

URL url = new URL (my__event_sub__url) ; 
// Build the header of the SOAP message 

ByteArrayOutputStream baosjieader = new ByteArrayOutput Stream ( ] ; 
baos_header. write ( (new String ( " SUBSCRIBE "+url.getFile () +" 
HTTP/1 . l\r\n") ) .getBytes () ) ; 

baos_header. write ( (new String ( "HOST : 
"+url .getHost ()+*': " +url . getPort ( ) + lf \rVn") ) .getBytes () ) ; 

if (subscriptionjjuid == null) { 

// We are doing the initial subscription 
baosjieader , write ( (new String ( " CALLBACK : 
< "+my_delivery_url+" >\r\n" ) ) .getBytes () ) ; 

baos_header. write ( (new String ("NT: upnp ; event \r\n" ) ) .getBytes () ) ; 
} else { 

// We are doing a renewing subscription 
baos_header .write ( (new String ("SID: 
uuid: "+ subscript ion_uuid+"\r\n" ) ) .getBytes () ) ; 

} 

baos__header .write ( (new String ( "TIMEOUT : Second- 
n +timeout+ n \r\n" ) ) .getBytes 0 ) ; 

baos_header .write ( (new String ( "\r\n") ) . getBytes ()) ; 
//System . out . println (baos_header . toString ( ) ) ; 

// Create the Socket for the connection to the device 
Socket sock = new Socket (url . getHost () , url . getPort ( } ) ; 
sock. setSoTimeout (3 00 00) ; 

OutputStream out = sock . getOutputStream ( ) ; 
InputStream in = sock. get InputStreamO ; 

// Send the Command 

out .write (baosjieader . toByteArray ( ) ) ; 
// Read the Response 
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try { 

infc len; 

byte b[] = new byte [100] ; 
StringBuffer sb = new StringBuf f er ( ) ; 
while ((len =. in. read (b) ) != -1) { 
sb .append (new String (b, 0 , len) ) ; 

} 

StringTokenizer st = new StringTokenizer (sb . toString () , "\n"); 

// Check for correct header 

if (st.hasMoreElementsO == false) { 

SoftwareElement . log (Software Element . MSG_WARNING f 
"ServiceDescription. sendEventSubscription () : Empty response! Give up ! " ) ; 

throw new HaviUnidentif iedFailureException ( (short) 0) ; 

} 

String line = st . nextToken ( ) .trimO ; 

if (line. equals ("HTTP/ 1.1 200 OK") == false) { 

SoftwareElement, log (SoftwareElement .MSG_WARNING, 
"ServiceDescription. sendEventSubscription () : Received wrong header in response: 
"+line) ; 

throw new HaviUnidentif iedFailureException ( (short) 0) ; 

} 

// Search for SID and TIMEOUT 
while {st .hasMoreElements () =- true) { 
line = st. next Token {) .trim 0 ; 

//SoftwareElement . log (Sof twareElement . MSG_INF0_L0W, 

"ServiceDescription. sendEventSubscription {) : "+line) ; 

if (line. length () == 0) break; 
if (line. startsWith ("SID:") == true) { 
// Found SID 

String complete_uuid = line . substring ( (new 
String ("SID: ") ) . length () ) .trim() ; 

if (conplete_uuid . startsWith ( "uuid: " ) -= false) { 

SoftwareElement . log (SoftwareElement . MSG__V7ARNING, 
"ServiceDescription. sendEventSubscription () : Wrong format in response line 
" +line) ; 

ret_value - false ; 
} else { 

String new_subscription_uuid = new 
String (complete_uuid. substring ( (new String ( "uuid: ") ) . length ()) .trimO); 

if ( subscription_uuid == null) { 

subscription_uuid = new_s ub script ion_uuid; 
} else { 

if 

(subscription_uuid . equals (new_subscription_uuid) == false) { 
SoftwareElement . log (SoftwareElement .MSG^WARWING, 

"ServiceDescription. sendEventSubscription () : The returned uuid changed! Ignore!"); 

} 

} 

} 

} 

if (line. startsWith ("TIMEOUT: ") == true) { 
// Found TIMEOUT 

subscription^ imeout = line . substring ( (new 
String ("TIMEOUT: ") ) . length () ) .trimO ; 

if (subscription_timeout . equals ( "infinite" ) == true) { 

subscription_expire_date = null; 
} else { 

if 

(subscription_timeout . toLowerCase (). startsWith (" second- " ) == false) { 

// Ignore wrong format 
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Scf twareElement . log (Sof twareElement .MSG_WARNING, 
" ServiceDe script ion. sendEvent Subscript ion () : Wrong format in response line 
"+line+" (Doesn't start with >Seccnd-<) . Assume >inf inite< " ) ; 

subscript ion_expire_date m null; 
} else { 

int itimeout = 
Integer .parse Int (subscription_timeout . substring (7) ) ; 

try { 

subscription expire_date = new Date(); 
subscription_expire_date . setTime ( (new 

Date{) ) .getTime () + (long) itimeout) ; 

} catch (Number For mat Except ion ex} { 
// Ignore wrong format 

Sof twareElement . log (Sof twareElement ,MSG_WARNING, 

"ServiceDescription. sendEventSubscription () : Wrong format in response line 
" + line+ 11 . Assume >infinite<") ; 

subscript ion_expire_date = null; 

} 

} 

} 

} 

} 

} catch ( java. io . IOException ex) { 

Sof twareElement . log (Sof twareElement . MS G_WARN ING , 
"ServiceDescription. sendEvent Sub script ion ( ) : Didn't receive a response from the 
UPnP device! ! !") ; 

ret_value = false; 
} catch (HaviUnidentif iedFailureException ex) { 
ret_value = false; 

} 

// Close streams and socket 
in , close ( ) ; 
out . close ( ) ; 
sock. close 0 ; 

} catch (java .net .UnknownHost Except ion e) { 

Sof twareElement . log (Sof twareElement . MSG_WARNING , 
"ServiceDescription. sendEventSubscription () : Host is unknown!"); 

ret_value = false; 
} catch (java.net . Socket Except ion e) { 

Sof twareElement . log (Sof twareElement . MSG_WARNING , 
" ServiceDescription . sendEventSubscription { ) : SocketException ! " ) ; 

ret_value = false; 
} catch (java. io. IOException ex) { 

Sof twareElement . log (Sof twareElement . MSG_WARNING , 
"ServiceDescription. sendEventSubscription ( ) : IOException!") ; 

ret__value = false; 

} 

return ret_value; 

} 

// 

// sendEventUnsubscription 

// An Event Unsubscription message is sent to the related UPnP service 

// 

public boolean sendEventUnsubscription ( ) 

{ 

// Check if an Event SUB URL is defined 
if (my_event_sub_url == null) { 
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Sof twareElement . log (Sof twareElement . MSG_WARNING, ■' ServiceDescript ion . sendEventUnsub 
scription() : No event sub URL defined. Give up!"); 

return false; 

if ( subscript ion_uuid == null) { 

Sof twareElement . log (Sof twareElement . MSG__WARNING/ " ServiceDescript ion . sendEventUnsub 
scription(): No Subscription UUID known. Give up!"); 

return false; 

} 

boolean ret_value = true; 
try { 

// Build the URL 

URL url = new URL (my_event__sub_url) ; 
// Build the header of the SOAP message 

ByteArrayOutputStream baos_header = new ByteArrayOutputStream () ; 

baos_header. write ( (new String { "UNSUBSCRIBE "+url .get File () +" 
HTTP/1. l\r\n") ) .getBytes () ) ; 

baos_header. write ( (new String ( "HOST: 
"+url .getHost () + " : " -Rirl . get Port () +"\r\n") ) .getBytes () ) ; 

baos_header .write ( (new String ("SID: 
uuid: "+subscription_uuid+"\r\n") ) .getBytes () ) ; 

baos_header .write ( (new String ( "\r\n" ) ) . getBytes ()) ; 

//System . out . println (baos_header . toStr ing ( ) ) ; 

// Create the Socket for the connection to the device 
Socket sock = new Socket (url . getHost () , url . getPort ( ) ) ; 
sock. setSoTimeout (30000) ; 

OutputStream out = sock. getOutputStream ( ) / 
InputStream in = sock . getlnputstreatn ( ) ; 

// Send the Command 

out . wr i te (baos_header . toBy teAr ray ( ) ) ; 

// Read the Response 
try { 

int len; 

byte b[] = new byte[lO0]; 
StringBuffer sb = new StringBuf f er ( ) ; 
while (den = in.read(b)) != -1) { 
sb . append (new String (b, 0 , len) ) ; 

} 

StringTokenizer st = new StringTokenizer (sb . toString ( ) , "\n"); 

// Check for correct header 

if (st .hasMoreElements () == false) { 

Sof twareElement . log ( Sof twareElement . MSG_WARNING, 
"ServiceDescription. sendEventUnsubscription () : Empty response! Give up!"); 

throw new HaviUnidentif iedFailureException ( (short) 0) ; 

} 

String line = st . nextToken ( ) .trim ( ) 

if (line. equals ("HTTP/ 1.1 200 OK") == false) { 

Sof twareElement . log ( Sof twareElement . MSG_ WARNING, 

"ServiceDescription . sendEventUnsubscription () : Received wrong header in response: 

"+line) ; 

throw new HaviUnidentif iedFailureException ( (short) 0) ; 

} 

} catch ( java. io . IOException ex) { 
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Sof twareElement . log (Sof twareElement . MSG_WARNING , 
"ServiceDescription. sendEventUnsubscription () : Didn't receive a response from the 

UPnP device !!!"); 

ret_value = false; 
} catch (HaviUnidentif iedFailureException ex) { 

ret_value = false; 

} 

// Close streams and socket 
in . close ( ) ; 
out . close { ) ; 
sock . close ( ) ; 

} catch ( java . net .UnknownHo st Except ion e) { 

Sof twareElement . log (Sof twareElement . M S G_W ARU I NG , 
"ServiceDescription. sendEventUnsubscription () : Host is unknown!' 1 ); 

ret_value = false; 
} catch ( j ava .net . SocketException e) { 

Sof twareElement . log (Sof twareElement . MSG_WARNING, 
"ServiceDescription. sendEventUnsubscription () : SocketException! ") ; 

ret_value = false; 
} catch {java. io. IOExcept ion ex) { 

Sof twareElement . log (Sof twareElement .MS G_WARNING / 
"ServiceDescription. sendEventUnsubscription ( ) : IOExcept ion I" ) ; 

ret_value = false; 

} 



return ret_value; 

} 

} Fig. 6 
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